GetItDoneGetItDone Docs
API ReferenceTask occurrences

List a task's occurrences

GET
/v1/tasks/{task_id}/occurrences

Cursor-paginated ledger of the days a repeating task is due, most recent day first. Filter with status, and with starting_on / ending_on for a calendar window (both inclusive, and both interpreted in the recurrence's own timezone). Future days already exist inside the materialization horizon — that is what makes completing early possible. A task that does not repeat answers an empty page rather than 404. Every filter is baked into the cursor: reusing an after cursor with different filters answers 400 validation_failed.

Authorization

bearerAuth
headerAuthorizationBearer <token>

A gid_ API key (Profile → API Keys) or an OAuth 2.1 access token.

Path Parameters

task_id*string

Task short id, e.g. T-123 (a bare 123 is also accepted on input).

Match^(?:T-)?[0-9]{1,12}$

Query Parameters

limit?integer

Maximum number of items to return (1-100).

Range1 <= value <= 100
Default25
after?string

Opaque cursor from a previous page's next_cursor — omit for the first page. Reusing a cursor with DIFFERENT query parameters (e.g. a different limit) answers 400 validation_failed.

status?string

Only occurrences currently in this state.

Value in"PENDING""COMPLETED""SKIPPED""MISSED"
starting_on?string

Only occurrences on or after this calendar day (YYYY-MM-DD).

Match^\d{4}-\d{2}-\d{2}$
ending_on?string

Only occurrences on or before this calendar day (YYYY-MM-DD).

Match^\d{4}-\d{2}-\d{2}$

Response Body

Page of occurrences.

application/json
  1. response

Cursor-envelope page of occurrences, most recent day first. A task that does not repeat answers an empty page.

data*array<>

The current page of results.

has_more*boolean

True when another page exists after this one.

next_cursor*|

Opaque cursor for the next page (pass as after); null on the last page.

Example Request
curl -X GET 'https://app.nowgetitdone.com/v1/tasks/T-123/occurrences'
Example Response
{  "data": [    {      "task_id": "T-123",      "occurrence_date": "2026-08-06",      "sequence": 12,      "status": "PENDING",      "completed_at": "2019-08-24T14:15:22Z"    }  ],  "has_more": true,  "next_cursor": "string"}

Remove a blocker DELETE

Removes the blocked-by link between the two tasks — neither task is otherwise touched, and completion history is untouched. Removing a link that is not there…

Complete or skip one day PATCH

Marks ONE day of a repeating task completed or skipped — the SAME shared operation the MCP complete_task_occurrence tool executes. The day may be in the PAST…