Skip to content

Fetch slots

Request

Returns bookable time slots for a staff member/service within the given date range. The date range (end_at - start_at) must not exceed 7 days.

Security
BearerAuth
Query
account_idstringrequired
Example:account_id=acc_123456
provider_idstringrequired

Staff member id.

Example:provider_id=provider_123456
durationinteger, [ 1 .. 1439 ]required

Meeting duration in minutes.

Example:duration=30
start_atstring, (date-time)required

Start of the range, an RFC 3339 date-time with an offset: Z for UTC or a numeric offset such as +08:00, in whole seconds. URL-encode the + as %2B.

Example:start_at=2026-11-19T00:00:00+08:00
end_atstring, (date-time)required

Must be within 7 days of start_at.

Example:end_at=2026-11-25T00:00:00+08:00
timezonestringrequired

IANA Time Zone Database identifier. The slot times in the response use the offset of this time zone.

Example:timezone=Asia/Singapore
slot_limitinteger, [ 1 .. 100 ]
Default:15
Example:slot_limit=15
double_bookingboolean
Default:false
Example:double_booking=false
working_hoursboolean
Default:false
Example:working_hours=false
curl -i -X GET \
  'https://developer.setmore.com/api/v2/slots?account_id=acc_123456&provider_id=provider_123456&duration=30&start_at=2026-11-19T00%3A00%3A00%2B08%3A00&end_at=2026-11-25T00%3A00%3A00%2B08%3A00&timezone=Asia%2FSingapore&slot_limit=15&double_booking=false&working_hours=false' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'

Responses

Slots fetched.

Bodyapplication/json
dataobject(Slots)

Bookable time slots grouped by day.

Response
{ "data": { "days": { … } } }