curl "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability?from=2024-01-15T00:00:00Z&to=2024-01-22T00:00:00Z&duration_minutes=30" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "data": [
    { "start_at": "2024-01-15T09:00:00Z", "end_at": "2024-01-15T09:30:00Z" },
    { "start_at": "2024-01-15T09:30:00Z", "end_at": "2024-01-15T10:00:00Z" },
    { "start_at": "2024-01-15T10:00:00Z", "end_at": "2024-01-15T10:30:00Z" }
  ]
}

GET

api

calendars

{calendar_id}

availability

curl "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability?from=2024-01-15T00:00:00Z&to=2024-01-22T00:00:00Z&duration_minutes=30" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "data": [
    { "start_at": "2024-01-15T09:00:00Z", "end_at": "2024-01-15T09:30:00Z" },
    { "start_at": "2024-01-15T09:30:00Z", "end_at": "2024-01-15T10:00:00Z" },
    { "start_at": "2024-01-15T10:00:00Z", "end_at": "2024-01-15T10:30:00Z" }
  ]
}

Query Availability

Compute available time slots for a calendar over a given range, applying recurring rules, exceptions, and existing events as busy time.

Endpoint

GET /api/v1/calendars/{calendar_id}/availability

Path parameters

string

required

Calendar UUID.

Query parameters

string

required

Range start. ISO 8601.

string

required

Range end. ISO 8601.

integer

Slot length to compute. Default: 30.

Request headers

string

required

Bearer token. Format: Bearer talq_your_environment_token_here

Examples

curl "https://app.talkover.ai/api/v1/calendars/calendar-uuid-1/availability?from=2024-01-15T00:00:00Z&to=2024-01-22T00:00:00Z&duration_minutes=30" \
  -H "Authorization: Bearer talq_your_environment_token_here"

Response

{
  "success": true,
  "data": [
    { "start_at": "2024-01-15T09:00:00Z", "end_at": "2024-01-15T09:30:00Z" },
    { "start_at": "2024-01-15T09:30:00Z", "end_at": "2024-01-15T10:00:00Z" },
    { "start_at": "2024-01-15T10:00:00Z", "end_at": "2024-01-15T10:30:00Z" }
  ]
}

Notes

Slots fall within recurring rules and exclude busy events and exception dates.
Use this endpoint to power scheduling agents — let the agent offer caller these slots.

Get Started

Concepts

API Reference

Guides

Query Availability

Query Availability

Endpoint

Path parameters

Query parameters

Request headers

Examples

Response

Notes

​Query Availability

​Endpoint

​Path parameters

​Query parameters

​Request headers

​Examples

​Response

​Notes

Query Availability

Endpoint

Path parameters

Query parameters

Request headers

Examples

Response

Notes