PRproductive
Tasks

Get tasks

Changed on

Returns a paginated list of tasks — the assignable work items inside a project's task lists. Supports filtering by project, task list, folder, parent task, assignee, creator, workflow status, dates (created, due, start, closed, last activity), tags, custom fields, subscribers, dependencies, and free-text query. Sortable by task number, due date, start date, last activity, placement, and workflow status.

get/api/v2/tasks

Request

  • Base URL
    https://developer.productive.io (the document declares no server; this is the origin it was published from)
  • URL
    https://developer.productive.io/api/v2/tasks
  • Auth
    none declared

Query parameters

OR

Filters

{
  "0": {
    "id": {
      "eq": "123"
    }
  },
  "$op": "and"
}
sortstring[]

Sort task

page[size]integer
page[number]integer
page[after]string
fieldsobject

Headers

X-Countstring
X-No-Countstring

Response

Collection task

Example response

{
  "data": [
    {
      "id": "120501",
      "type": "tasks",
      "attributes": {
        "title": "Implement user authentication",
        "description": "Set up OAuth2 authentication with Google and GitHub providers",
        "number": "42",
        "task_number": "42",
        "private": false,
        "due_date": "2026-03-31",
        "start_date": "2026-03-15",
        "closed_at": null,
        "closed": false,
        "created_at": "2026-01-15T10:00:00.000+00:00",
        "updated_at": "2026-03-10T14:30:00.000+00:00",
        "email_key": "7a083181e1e5f5dc5c11920d72804716",
        "custom_fields": null,
        "todo_count": 3,
        "open_todo_count": 1,
        "subtask_count": 2,
        "open_subtask_count": 1,
        "task_dependency_count": 0,
        "type_id": 1,
        "blocking_dependency_count": 0,
        "waiting_on_dependency_count": 0,
        "linked_dependency_count": 0,
        "placement": 1000000,
        "subtask_placement": null,
        "tag_list": [
          "backend",
          "security"
        ],
        "last_activity_at": "2026-03-10T14:30:00.000+00:00",
        "initial_estimate": 480,
        "remaining_time": 240,
        "billable_time": 120,
        "worked_time": 240,
        "deleted_at": null
      },
      "relationships": {
        "project": {
          "data": {
            "type": "projects",
            "id": "6899"
          }
        },
        "creator": {
          "data": {
            "type": "people",
            "id": "12"
          }
        },
        "assignee": {
          "data": {
            "type": "people",
            "id": "12"
          }
        },
        "task_list": {
          "data": {
            "type": "task_lists",
            "id": "14308"
          }
        },
        "workflow_status": {
          "data": {
            "type": "workflow_statuses",
            "id": "224"
          }
        },
        "service": {
          "data": null
        },
        "parent_task": {
          "data": null
        }
      }
    }
  ],
  "included": [],
  "meta": {
    "current_page": 1,
    "total_pages": 5,
    "total_count": 42,
    "page_size": 30,
    "max_page_size": 200
  }
}

Changes

  • e7bdfdf6cba3Revision changes
    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

  • fa3060fd0144Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status