Skip to navigation

Move a booking to another time

Moves the whole booking — every ticket on it — to the time that starts at startDate + startTime, one of the slots from the schedule call. All of it moves or none of it does; tickets, quantities and price stay as they are, and no new order or receipt is created. No email is sent: show the answer as the confirmation; the shopper’s existing e-tickets show the new time from now on. Choosing the current time changes nothing and answers 200. Requires the account token.

Authentication

AuthorizationBearer

Account token, browser-safe. Obtain one from POST /api/account/session with the 6-digit code POST /api/account/login emailed to the shopper; valid 30 minutes, for one store and one proven email, and it reads only that account’s own data. Sent as Authorization: Bearer <token>. Not interchangeable with the BearerAuth client token in either direction.

Path parameters

reservationTokenstringRequired>=1 character

From GET /api/account/bookings.

Headers

x-entriastringRequired

Identifies which store this request is for. Required on every store-scoped route. It is not authentication and not a secret — it grants no privileges and is safe to send from a browser. You receive the value once your Entria backend has been created and configured. Missing header returns 400; an unknown store returns 404.

Request

This endpoint expects an object.
startDatestringRequiredformat: "^\d{4}-\d{2}-\d{2}$"
startTimestringRequiredformat: "^\d{2}:\d{2}:\d{2}$"

Response

The move is done: the booking at its new time, in the same shape as in the list — the data for a success page. Its reservationToken usually differs from the one in the path: use the new one from now on.

reservationTokenstring

Identifies the booking in the schedule and reschedule calls. It changes when the booking moves: take it from the latest list or reschedule answer.

visitobject or null
The current time. Null when parts of the booking sit at different times.
lineslist of objects
reschedulableboolean
Whether the booking can be moved now. Only these open the schedule and reschedule calls.
reasonslist of objects

Why it cannot move; empty when it can. reasonCode is MIXED_TIMES (parts of the booking are at different times, so it cannot move as one), or the ticketing system’s own code: CUTOFF_PASSED, ALREADY_ADMITTED, SLOT_PASSED, TICKET_BLOCKED, TICKET_EXPIRED, NOT_CONFIGURED, NOT_ALLOWED and others it adds. Can be empty for a booking that cannot move, when the system gave no reason.

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
500
Internal Server Error
502
Bad Gateway Error
503
Service Unavailable Error