---
title: "Get queryable calendars for a connected account"
method: GET
path: "/open/v1/calendar/account/{accountId}/calendars"
---

# Get queryable calendars for a connected account

`GET /open/v1/calendar/account/{accountId}/calendars`

## Request

- Base URL: `https://ticktick.com`
- URL: `https://ticktick.com/open/v1/calendar/account/{accountId}/calendars`
- Auth: none declared

Returns stored calendar metadata, excluding hidden or unsupported calendars. Use the returned local IDs in calendarIds when querying events.

## Path parameters

- `accountId` string, required

## Response `200`

Queryable calendars belonging to the selected account.

- Calendar[]
  - `id` string: Local calendar ID used in calendarIds.
  - `name` string
  - `color` string
  - `timeZone` string

## Other responses

- `400`: Missing or blank accountId.
- `404`: Calendar account not found (calendar_account_not_found).

## Changes

- **2026-11-13** `bbd09df38f88`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ticktick/apis/ticktick-openapi/changes/open/v1/calendar/account/:accountId/calendars/get.md)

---

[API](https://skmtc.dev/ticktick/apis/ticktick-openapi.md) - [All operations](https://skmtc.dev/ticktick/apis/ticktick-openapi/llms.txt) - [OpenAPI document](https://skmtc.dev/ticktick/apis/ticktick-openapi/revisions/bbd09df38f88?raw)