Add one or more lines to a cart
Adds one or more items to an existing cart and returns the updated cart with recalculated totals. For a timed ticket, this is the call that actually holds capacity — checking availability or requesting a quote reserves nothing on its own. Pass identity to apply any customer-specific pricing to the new lines.
Headers
x-entria
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.
Query parameters
identity
Opaque encrypted token identifying the shopper, used to apply customer-specific pricing to the new lines. Pass it through unchanged; it is not meant to be decoded by the caller.
Request
This endpoint expects an object.
cartId
Id of the cart to add lines to, as returned when it was created.
lines
One or more lines to add. Every line needs a type (TICKET, ATTRACTION_PACKAGE, MEMBERSHIP, VOUCHER, DONATION, or GENERIC), a product sku, and a quantity. TICKET lines send date and startTime together — both, or neither. Neither is only valid for a next-available product, where the slot is assigned automatically; if the product requires a schedule, one without the other is rejected and so is a schedule-requiring ticket sent with neither. ATTRACTION_PACKAGE lines always need both date and startTime. VOUCHER and DONATION lines need a price for the amount the shopper entered; MEMBERSHIP lines need an activationDate.
Response
The cart after the new lines were added, with recalculated totals and, for timed tickets, an active capacity hold.
cart
Errors
400
Bad Request Error
404
Not Found Error
500
Internal Server Error