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

# GET /api/tasks

`GET /api/tasks`

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

---

[API](https://skmtc.net/drchrono/apis/untitled-api.md) · [All operations](https://skmtc.net/drchrono/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drchrono/untitled-api/versions/e595797fe800/schema)