Skip to main content
GET
/
calendar
/
calendars
List Calendars
curl --request GET \
  --url https://api.example.com/calendar/calendars
{
  "calendars": [
    {
      "id": "<string>",
      "google_calendar_id": "<string>",
      "name": "<string>",
      "color": "<string>",
      "is_primary": true,
      "google_account_id": "<string>",
      "account_email": "<string>",
      "account_name": "<string>",
      "needs_reauth": true,
      "access_role": "<string>"
    }
  ]
}

Endpoint

GET /calendar/calendars
Retrieves all Google calendars associated with the authenticated user’s connected Google accounts. This endpoint returns calendars from all linked Google accounts.

Authentication

Requires a valid authentication token in the request headers.

Response

calendars
array
required
Array of calendar objects

Example Request

cURL
curl -X GET "https://api.chronoscalendar.com/calendar/calendars" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Example Response

{
  "calendars": [
    {
      "id": "cal_abc123",
      "google_calendar_id": "[email protected]",
      "name": "Personal",
      "color": "#9fe1e7",
      "is_primary": true,
      "google_account_id": "acc_xyz789",
      "account_email": "[email protected]",
      "account_name": "John Doe",
      "needs_reauth": false,
      "access_role": "owner"
    },
    {
      "id": "cal_def456",
      "google_calendar_id": "[email protected]",
      "name": "Work Calendar",
      "color": "#f09300",
      "is_primary": false,
      "google_account_id": "acc_xyz789",
      "account_email": "[email protected]",
      "account_name": "John Doe",
      "needs_reauth": false,
      "access_role": "writer"
    }
  ]
}

Error Responses

401 Unauthorized
Authentication token is missing or invalid
500 Internal Server Error
An unexpected error occurred while fetching calendars

Source Code Reference

See implementation in backend/app/routers/calendar.py:111-114 and backend/app/calendar/db.py:190-198

Build docs developers (and LLMs) love