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" }
]
}
Availability
Query Availability
Compute available time slots for a calendar
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
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_hereExamples
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.
Was this page helpful?