Query events from connected calendar accounts

Changed on

Query events from one account selected by required accountId and a non-empty calendarIds list obtained from the calendar list endpoint. Hidden, unsupported, or foreign calendars are rejected. When no time range is supplied, the range is now through the following three months. A query range may not exceed three months. Recurring events depend on whether the calendar provider returns expanded occurrences; a recurring series that starts outside the range may be omitted even if it has occurrences inside the range. status is complete, partial, or failed. accountErrors gives stable failure codes per account; errorAccountIds remains for compatibility. HTTP 200 with failed means the selected account could not be queried. An unknown or inaccessible account returns 404.

post/open/v1/calendar/event/query

Request

  • Base URL
    https://ticktick.com
  • Auth
    none declared

Request body

accountIdstring required

Required connected calendar account ID.

calendarIdsstring[] required

Required non-blank local calendar IDs belonging to the account and returned by the calendar list endpoint.

beginstring

Accepts the TickTick timestamp format, e.g. "2026-09-24T10:00:00.000+0800", or an ISO 8601 timestamp with offset.

endstring

Accepts the TickTick timestamp format, e.g. "2026-09-24T10:00:00.000+0800", or an ISO 8601 timestamp with offset.

Response

Events and any accounts that could not be queried.

status'complete' | 'partial' | 'failed'
beginstring

Resolved query start in "yyyy-MM-dd'T'HH:mm:ss.SSSZ" format (e.g. "2026-09-24T10:00:00.000+0800").

endstring

Resolved query end in "yyyy-MM-dd'T'HH:mm:ss.SSSZ" format (e.g. "2026-09-24T10:00:00.000+0800").

errorAccountIdsstring[]

Accounts that could not be queried; events from other accounts are still returned.

Changes