Get Booking

GET 
/v1/open-api/booking/:id

Get a single booking by ID (scoped to the token's company). The response carries the same fields as a list row plus flatDetails — the full apartment object, identical in shape to GET /v1/open-api/flat/{id}.

Note: an unknown ID answers 409 Conflict (BOOKING_NOT_FOUND), not 404.

Requires grant PERMISSION_OPEN_API_BOOKING:READ.

Request

Responses

200

The booking.

401

Invalid, revoked or expired token (401) — also returned when the connection was revoked or the company is blocked.

Produced by the authentication filter, so the body is a reduced envelope: no error, no requestId, and errors is null rather than []. Every cause yields the same fixed English message.

403

The token lacks the required permission:scope grant (403).

409

Booking not found (BOOKING_NOT_FOUND) — this endpoint answers 409, not 404.

429

Rate limit of 60 requests/minute exceeded (429). Like 401, this comes from the authentication filter: reduced envelope, fixed English message, no error object and no Retry-After header.