Get free slots of a calendar
GET/api/v2/scheduling/calendars/:id/free-slots
Returns the bookable slots of a calendar for a date range, grouped by day.
The whole computation is performed by gesmo-scheduling-core, the same engine the booking guard uses on write, so what this endpoint offers and what a POST /api/v2/scheduling/events accepts cannot drift apart.
timezone is mandatory and explicit: the grid is built in the IANA zone you ask for and startAt / endAt carry that zone's offset. There is no server default ÔÇö tenants live in Europe/Madrid, America/Panama and America/Costa_Rica, and the same calendar is read from all three.
Every requested day is present in the response, with an empty slots list when there is nothing to offer: "closed that day" and "outside the range you asked for" are different answers.
Restricting by staff is optional. employeeId / employeeIds are the canonical names; trabajadorId / trabajadorIds and the GHL spellings userId / userIds are accepted as aliases and merged into one set.
The range is capped at 31 days.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
Availability for the requested range
Missing or unparseable timezone / dates, inverted range, or a range longer than 31 days
Missing or invalid JWT (Bearer token).
Authenticated user is missing the VER_CALENDARIOUI permission
Calendar not found or outside the caller's company scope
Unexpected server error. Includes legacy WAR failures that are not classified as 502 / 503 / 504.