API Reference

Availability

Compute bookable slots for a business. Availability factors in opening hours, staff schedules, breaks, absences, existing bookings, buffer times, and advance-booking rules, so you can show a customer exactly what they can book and then create it.

Scope and plan

All availability routes are read-only and require the availability:read scope. API keys are available on the PRO and ENTERPRISE plans.

Get available slots

GET/businesses/{businessId}/availability

availability:readPRO plan

Path parameters

Name	Type	Required	Description
`businessId`	uuid	Required	Your business id.

Query parameters

Name	Type	Required	Description
`startDate`	date	Required	First day to compute slots for (YYYY-MM-DD).
`endDate`	date	Optional	Last day. Defaults to startDate.
`staffId`	uuid	Optional	Restrict to a single staff member.
`serviceId`	uuid	Optional	Size slots to a service's duration.
`serviceIds`	uuid[]	Optional	Multiple services booked together.
`duration`	integer	Optional	Override duration in minutes.
`skipAdvanceCheck`	boolean	Optional	Skip the minimum advance-booking rule.

curl "https://api.salonify.eu/api/v1/businesses/b_8f3a/availability?startDate=2026-07-02&serviceId=sv_77" \
  -H "X-API-Key: sk_live_..."

Response

{
  "businessId": "b_8f3a",
  "days": [
    {
      "date": "2026-07-02",
      "isOpen": true,
      "openTime": "09:00",
      "closeTime": "18:00",
      "slots": [
        { "startTime": "09:00", "endTime": "10:00", "available": true, "staffId": "st_4d11", "staffName": "Marie", "capacity": 1 },
        { "startTime": "10:00", "endTime": "11:00", "available": false }
      ],
      "closedReason": null
    }
  ]
}

Check a specific slot

POST/businesses/{businessId}/availability/check

availability:readPRO plan

Validates one exact slot before you create the booking and returns the computed duration and price.

Body parameters

Name	Type	Required	Description
`date`	date	Required	The date to check (YYYY-MM-DD).
`startTime`	string	Required	Start time in HH:mm.
`serviceId`	uuid	Required	Primary service.
`staffId`	uuid	Optional	Specific staff member.
`additionalServiceIds`	uuid[]	Optional	Extra services booked in the same slot.

curl -X POST "https://api.salonify.eu/api/v1/businesses/b_8f3a/availability/check" \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{ "date": "2026-07-02", "startTime": "09:00", "serviceId": "sv_77" }'

Response

{
  "available": true,
  "reason": null,
  "suggestedStaffId": "st_4d11",
  "suggestedTime": "09:00",
  "endTime": "10:00",
  "totalDuration": 60,
  "totalPrice": 45
}

Find available staff for a slot

GET/businesses/{businessId}/availability/staff

availability:readPRO plan

Query parameters

Name	Type	Required	Description
`date`	date	Required	The date (YYYY-MM-DD).
`startTime`	string	Required	Start time in HH:mm.
`duration`	integer	Required	Duration in minutes.
`serviceIds`	uuid[]	Optional	Restrict to staff who perform these services.

curl "https://api.salonify.eu/api/v1/businesses/b_8f3a/availability/staff?date=2026-07-02&startTime=09:00&duration=60" \
  -H "X-API-Key: sk_live_..."

Response

[
  { "id": "st_4d11", "name": "Marie Dupont" },
  { "id": "st_5e22", "name": "Tom Klein" }
]