Booking Codes

Unavailable windows for the calendar bound to a booking code

Changed on

Unauthenticated, code-gated read of a calendar's unavailable windows.

GET /public/booking/unavailable-windows/ ports public_api.queries.Query.unavailable_windows_with_code to REST. The calendar comes from the resolved token (token.calendar, falling back to token.event.calendar); no calendar id is accepted from the client.

get/public/booking/unavailable-windows/

Request

  • The document declares no server URL.
  • Auth: none declared. Required headers: X-Booking-Code

Query parameters

end_datetimestring required

End of the query window (ISO 8601).

start_datetimestring required

Start of the query window (ISO 8601).

Headers

X-Booking-Codestring required

Single-use booking code. Every failure -- invalid, expired, used, revoked, or wrong-scope -- returns the same 403 {"detail": "Invalid or expired code."}; this endpoint never discloses which one occurred. Repeatable: never consumed by a read.

Response

idinteger required
reasonstring required
start_timestring date-time required
end_timestring date-time required
reason_descriptionstring required

Changes