API ReferenceAvailability
List open slots
Returns bookable start times for a service at a location on a given date (or date range). Honors the location's business hours, staff schedules, existing bookings, and booking rules, exactly like the public booking page.
Authorization
ApiKeyAuth AuthorizationBearer <token>
Send your API key as a bearer token: Authorization: Bearer bp_sk_live_.... Mint and revoke keys in your dashboard under Settings -> Developers.
In: header
Query Parameters
location_id*string
Format
uuidservice_id*string
Format
uuiddate*string
Start date (YYYY-MM-DD), interpreted in the location's timezone.
Format
datedays?integer
Number of days from date to include (1-31). Defaults to 1.
Range
1 <= value <= 31Default
1technician_id?string
Restrict to a specific staff member.
Format
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/availability?location_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&service_id=497f6eca-6276-4993-bfeb-53cbbbba6f08&date=2019-08-24"{ "location_id": "46910cc3-ab41-4b80-b4a7-94dab9f1b795", "service_id": "641e839f-864e-4cce-98f9-40f6cbb3e9e0", "slots": [ { "start": "2019-08-24T14:15:22Z", "end": "2019-08-24T14:15:22Z", "technician_id": "557e6e8c-3c29-4825-b73f-0884ad39f2d9" } ]}