Skip to content
REST API

Get a task

GET
/tasks/{taskId}

Returns one task or subtask with its subtask count and recurrence rule. List a task's subtasks with GET /tasks?parentId=<taskId>.

Required scopes: tasks:view

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

taskId*string

Task id, scoped to the key's user.

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/tasks/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "data": {    "id": "4d3c2b1a-0f9e-4d8c-9b7a-6f5e4d3c2b1a",    "name": "Finish lab report",    "description": "Include the error analysis.",    "type": "Generic",    "subjectId": "5f0c1d2e-3a4b-4c5d-8e6f-7a8b9c0d1e2f",    "dueDate": "2026-02-10T17:00:00.000Z",    "completed": false,    "parentId": null,    "createdAt": "2026-01-15T09:30:00.000Z",    "updatedAt": "2026-02-01T12:00:00.000Z",    "subtaskCount": 2,    "recurrence": {      "unit": "week",      "interval": 1,      "endsAt": null    }  }}