List calendars.

GET/api/v1/calendars

Browse API endpoints

Calendar and booking / CRM REST API

Scope: availability:read

Returns all active calendars for the sub-account. The list carries no customer data of its own, so a booking integration no longer has to hold the appointment roster just to discover which calendars exist.

Response:

Code example

{
  "data": [
    {
      "id": "cal_abc123",
      "name": "Main Calendar",
      "type": "personal",
      "timezone": "America/New_York"
    }
  ]
}

Loading endpoint details...

Build a request

Request example

Documented defaults and example values are ready. Change only the parameters you need.

Connection

Your CRM deployment URL

Replace the Bearer API key placeholder in the copied server-side code. No API key is entered or sent here.

Sub-account ID Agency keys onlyAgency-scoped keys require the X-Sub-Account-Id header.

cURL

curl --request GET \
  --url 'https://your-crm.example.com/api/v1/calendars' \
  --header 'Authorization: Bearer <YOUR_API_KEY>'

This shows a static response from the documentation. It does not send a request to your CRM or use an API key.