Skip to main content
GET
/
api
/
v1
/
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

​
calendar_id
string
required
Calendar UUID.

​
Query parameters

​
from
string
required
Range start. ISO 8601.
​
to
string
required
Range end. ISO 8601.
​
duration_minutes
integer
Slot length to compute. Default: 30.

​
Request headers

​
Authorization
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.