---
title: "GET /api/tasks"
method: GET
path: "/api/tasks"
tags: ["Practice Management"]
---

# GET /api/tasks

`GET /api/tasks`

## Request

- Base URL: `https://app.drchrono.com`
- URL: `https://app.drchrono.com/api/tasks`
- Auth: OAuth 2
  - Authorization code: `https://app.drchrono.com/o/authorize/`
  - Token URL: `https://app.drchrono.com/o/token/` scopes: `tasks:read`, `tasks:write`

Retrieve or search tasks

## Query parameters

- `cursor` string: The pagination cursor value.
- `page_size` integer: Number of results to return per page.
- `status` integer
- `category` integer
- `due_at_date` string
- `due_at_unknown` string
- `since` string
- `due_at_since` string
- `assignee_user` integer
- `assignee_group` integer
- `due_at_range` string

## Response `200`

OK

- object: Paginated Result
  - `previous` string: Previous paginated page
  - `data` Task[]: result data
    - `category` integer
    - `due_date` object: When the task is due
      - `time` string: Due date time
    - `archived` boolean
    - `associated_items` object[]: Associated task items
      - `task` integer
      - `type` 'Document' | 'Message' | 'Message Thread' | 'Lab result' | 'Lab order' | 'Patient' | 'Appointment' | 'Lab document' | 'Communication': Can be one of `"Appointment"`, `"Patient"`, `"Message"`, `"Message Thread"`, `"Document"`, `"Lab order"`
      - `value` integer: ID of the specified type object
    - `assigned_by` string: ID of `/api/users/` who assigned the task
    - `assignee_user` string: Either `assignee_user` or `assignee_group` should be set
    - `created_at` string
    - `assignee_group` integer: Either `assignee_user` or `assignee_group` should be set
    - `updated_at` string
    - `created_by` string: ID of `/api/users` who created the task
    - `priority` '10' | '20' | '30' | '40': Can be one of the following 10(Low), 20(Medium), 30(High), 40(Urgent)
    - `status` integer, required
    - `notes` object[]: Additional notes of the task
      - `archived` boolean
      - `task` integer: ID of `/api/tasks`
      - `text` string
      - `created_at` string
      - `updated_at` string
      - `created_by` string
      - `id` integer
    - `title` string, required
    - `id` integer
  - `next` string: Next Paginated page

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Permission Denied
- `404`: Not Found
- `405`: Method Not Allowed
- `500`: Internal Server Error

## Changes

- **2026-07-26** `e595797fe800`: 1 warning
  - added the new `Message Thread` enum value to the `data/items/associated_items/items/type` response property for the response status `200`

[Operation history](https://skmtc.dev/drchrono/apis/drchrono-api/changes/api/tasks/get.md)

---

[API](https://skmtc.dev/drchrono/apis/drchrono-api.md) - [All operations](https://skmtc.dev/drchrono/apis/drchrono-api/llms.txt) - [OpenAPI document](https://skmtc.dev/drchrono/apis/drchrono-api/revisions/98cabe79d150?raw)