Get calendar availability

Returns free/busy slots for a single calendar.

get/v1/calendars/{id}/availability

Request

Base URL: https://api.chronary.ai
URL: https://api.chronary.ai/v1/calendars/{id}/availability
Auth: HTTP bearer

Path parameters

idstring required

Calendar ID

Example:cal_01H9X4M2P5R8T6V0

Query parameters

startstring date-time required

endstring date-time required

duration'15m' | '30m' | '45m' | '1h' | '2h'

slot_duration'15m' | '30m' | '45m' | '1h' | '2h'

include_busy'true' | 'false'

allow_stale'true' | 'false'

Response

Availability slots

calendar_idstring required

availability_state'complete' | 'stale' | 'partial' | 'unavailable' required

Whether all required Chronary and authorized human-calendar data was current for this result.

Example response

{
  "calendar_id": "cal_01H9X4M2P5R8T6V0",
  "slots": [
    {
      "start": "2025-01-20T09:00:00.000Z",
      "end": "2025-01-20T09:30:00.000Z"
    }
  ],
  "busy": [
    {
      "start": "2025-01-20T09:00:00.000Z",
      "end": "2025-01-20T09:30:00.000Z"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.