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

# GET /api/tasks/{id}

`GET /api/tasks/{id}`

## Request

- Base URL: `https://app.drchrono.com`
- URL: `https://app.drchrono.com/api/tasks/{id}`
- 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 an existing task

## Path parameters

- `id` string, required

## Query parameters

- `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

- Task
  - `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

## 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 `associated_items/items/type` response property for the response status `200`

[Operation history](https://skmtc.dev/drchrono/apis/drchrono-api/changes/api/tasks/:id/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)