---
title: "List tasks"
method: GET
path: "/v2/tasks"
tags: ["Tasks"]
---

# List tasks

`GET /v2/tasks`

List all tasks. Results are sorted by creation date, from oldest to newest.

Required scopes: `task:read`, `object_configuration:read`, `record_permission:read`, `user_management:read`.

## Query parameters

- `limit` integer — The maximum number of results to return. Defaults to 500. See the [full guide to pagination here](/docs/pagination).
- `offset` integer — The number of results to skip over before returning. Defaults to 0. See the [full guide to pagination here](/docs/pagination).
- `sort` 'created_at:asc' | 'created_at:desc' — Optionally sort the results. "created_at:asc" returns oldest results first, "created_at:desc" returns the newest results first. If unspecified, defaults to "created_at:asc" (oldest results first).
- `linked_object` string — Pass a value to this parameter to filter results to only those tasks that contain the specified record in the `linked_records` property of the task. This parameter should identify the object that the linked record belongs to. For example, if filtering to tasks that link to a specific person record, this parameter should be `people`. If provided, `linked_record_id` must also be provided.
- `linked_record_id` string, uuid — Pass a value to this parameter to filter results to only those tasks that contain the specified record in the `linked_records` property of the task. This parameter should contain the record ID of the linked record. If provided, `linked_object` must also be provided.
- `assignee` string, nullable — Filter tasks by workspace member assignees. Workspace members can be referenced by either their email address or ID. Pass an empty value or the string `null` to find tasks with no assignee.
- `is_completed` boolean — Filter tasks by whether they have been completed. By default, both completed and non-completed tasks are returned. Specify `true` to only return completed tasks, or `false` to only return non-completed tasks.

## Response `200`

Success

- object — Success
  - `data` Task[], required
    - `id` object, required
      - `workspace_id` string, uuid, required — The ID of the workspace the task belongs to.
      - `task_id` string, uuid, required — The ID of the task.
    - `content_plaintext` string, required — The plaintext representation of the task content. Inline linked records will appear as "@record name" and are returned in the `linked_records` property.
    - `deadline_at` string, nullable, required — The deadline date of the task. Returned as an ISO 8601 timestamp.
    - `is_completed` boolean, required — Whether the task has been completed.
    - `linked_records` object[], required — Records linked to the task. Creating record links within task content text is not possible via the API at present.
      - `target_object_id` string, required — The ID of the parent object the task refers to. At present, only `people` and `companies` are supported.
      - `target_record_id` string, uuid, required — The ID of the parent record the task refers to.
    - `assignees` object[], required — Workspace members assigned to this task.
      - `referenced_actor_type` 'api-token' | 'workspace-member' | 'system' | 'app', required — The type of actor. [Read more information on actor types here](/docs/actors).
      - `referenced_actor_id` string, uuid, required — The ID of the workspace member actor assigned to this task.
    - `created_by_actor` object, required — The actor that created this task.
      - `id` string, nullable — An ID to identify the actor.
      - `type` 'api-token' | 'workspace-member' | 'system' | 'app', nullable — The type of actor. [Read more information on actor types here](/docs/actors).
    - `created_at` string, required — When the task was created.

---

[API](https://skmtc.net/d-stoll/apis/attio-api.md) · [All operations](https://skmtc.net/d-stoll/apis/attio-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/d-stoll/attio-api/revisions/ebcf9b5c6aa3/schema)