# List tasks

> Get the tasks of your Quenza workspace through the API, newest first, for everyone or only for one client or team member.

Source: https://quenza.com/help/api/tasks/list-tasks/

Returns all tasks of the workspace, newest first, both done and open ones.

To get the tasks of one person, send `assignee_type` and `assignee_id` together: `client` with a client's ID, or `professional` with a member's ID. With only one of the two, you get all tasks.

`client_id` says which client a task is about; `assignee_id` says who has to do it. A task Sarah Bennett has to do for Emma Clarke has Emma's ID in `client_id` and Sarah's in `assignee_id`. See [Tasks](https://quenza.com/help/working-with-clients/tasks/).

## Request

`GET https://developers.quenza.com/v1/tasks`

### Query parameters

- `offset` (integer): How many records to skip. Defaults to `0`.
- `limit` (integer): How many records to return, from 1 to 100. Defaults to `20`.
- `assignee_type` (string): Only tasks for this kind of assignee: `client` or `professional`. Use together with `assignee_id`. One of `client`, `professional`
- `assignee_id` (string): Only tasks assigned to this client or member. Use together with `assignee_type`.

### Example

```bash
curl "https://developers.quenza.com/v1/tasks?assignee_type=client&assignee_id=8GJ4D9KQ" \
  -H "Authorization: Bearer $QUENZA_API_TOKEN" \
  -H "Accept: application/json"
```

## Response

200 OK.

### Fields of each record in data

- `id` (string): The task’s ID.
- `title` (string): What has to be done.
- `client_id` (string, or null): ID of the client the task belongs to, or `null`.
- `assignee_type` (string): Who has to do the task: a `client` or a `professional` (a member). One of `client`, `professional`
- `assignee_id` (string): ID of the client or member who has to do the task.
- `is_completed` (boolean): Whether the task is done.
- `due_at` (string, or null): When the task is due, or `null`. ISO 8601 date and time in UTC
- `completed_at` (string, or null): When the task was completed, or `null`. ISO 8601 date and time in UTC
- `created_at` (string): When it was created. ISO 8601 date and time in UTC
- `updated_at` (string): When it was last changed. ISO 8601 date and time in UTC

```json
{
  "data": [
    {
      "id": "T5HQ2M8C",
      "title": "Fill in the intake questionnaire",
      "client_id": "8GJ4D9KQ",
      "assignee_type": "client",
      "assignee_id": "8GJ4D9KQ",
      "is_completed": false,
      "due_at": "2026-11-20T17:00:00.000000Z",
      "completed_at": null,
      "created_at": "2026-11-13T11:00:00.000000Z",
      "updated_at": "2026-11-13T11:00:00.000000Z"
    }
  ],
  "meta": {
    "limit": 20,
    "offset": 0,
    "total": 1
  },
  "links": {
    "next": null,
    "prev": null
  }
}
```

Status codes: 200 OK, 401 Unauthenticated, 402 Workspace not active, 403 Not on your plan, 406 Not acceptable. See /help/api/errors/.
