Availability

Query available time slots for an event type and check free/busy status for team members.

Get available slots

GET /v1/availability?event_type_id={id}&start_date={ISO}&end_date={ISO}&timezone={tz}

Prop	Type	Default
`event_type_id`	`string`	-
`start_date`	`ISO 8601`	-
`end_date`	`ISO 8601`	-
`timezone`	`string`	-

curl "https://api.slatis.com/v1/availability?event_type_id=evt_01abc&start_date=2026-05-01&end_date=2026-05-02&timezone=America/New_York" \
  -H "Authorization: Bearer sk_live_xxx"

{
  "success": true,
  "slots": [
    { "start": "2026-05-01T13:00:00.000Z", "end": "2026-05-01T13:30:00.000Z" },
    { "start": "2026-05-01T14:00:00.000Z", "end": "2026-05-01T14:30:00.000Z" }
  ]
}

Slots are returned in UTC. The timezone parameter controls which local working hours are used when generating slots — it does not change the response format. The total number of available slots is slots.length.

Slot intervals

Slots are generated based on the event type's slot_interval (defaults to duration). A 30-minute event type with a 15-minute interval produces overlapping start times — e.g. 09:00, 09:15, 09:30, etc.

Free/Busy

Query busy/free blocks for a team member without exposing individual booking details:

GET /v1/freebusy/{userId}?start={ISO}&end={ISO}&time_slot=30

Requires the availability:read scope. Public keys (pk_*) are accepted, so this endpoint is safe to call from the browser. Results are scoped to your organization — you cannot query members outside your org.

curl "https://api.slatis.com/v1/freebusy/usr_01abc?start=2026-05-01T00:00:00Z&end=2026-05-02T00:00:00Z" \
  -H "Authorization: Bearer pk_live_xxx"

Get available slots

Slot intervals

Free/Busy

On this page