Skip to main content
GET
/
api
/
v1
/
calendars
curl "https://app.talkover.ai/api/v1/calendars" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "data": [
    {
      "id": "calendar-uuid-1",
      "name": "Sales Demo Calendar",
      "timezone": "America/New_York",
      "owner_id": "user-uuid-1",
      "created_at": "2024-01-01T10:00:00Z"
    }
  ]
}

​
List Calendars

List calendars in the environment. Calendars hold events, members, and provider connections — typically used by agents that schedule appointments.

​
Endpoint

GET /api/v1/calendars

​
Query parameters

​
per_page
integer
Items per page. Range: 1–100. Default: 25.

​
Request headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

​
Examples

curl "https://app.talkover.ai/api/v1/calendars" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Response

{
  "success": true,
  "data": [
    {
      "id": "calendar-uuid-1",
      "name": "Sales Demo Calendar",
      "timezone": "America/New_York",
      "owner_id": "user-uuid-1",
      "created_at": "2024-01-01T10:00:00Z"
    }
  ]
}