Create or refresh a reservation
Prices the cart and holds the requested stock for the checkout window.
Returns a reservationToken and a quoteReference. Send the
X-Device-ID header to refresh/extend an existing reservation for the
same attendee; omit it to start a new one (a token is minted and
returned). Seat Map events return 400.
Authorization
ApiKeyAuth Your public API key (e.g. jt_public_...) passed as a Bearer token.
In: header
Path Parameters
The event's URL slug.
Header Parameters
The reservationToken (a UUID) identifying the attendee's cart. Strongly
recommended: generate one stable UUID per attendee (persist it in the
browser) and send it on every call so each attendee maps to exactly one
reservation. Send it to refresh that reservation.
If omitted, the server reuses a single token per client IP + event for the reservation window, so repeated requests don't each hold fresh stock, but distinct attendees behind the same IP would then share a reservation, so supplying your own per-attendee token is preferred.
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/events/string/reservations" \ -H "Content-Type: application/json" \ -d '{ "items": [ { "sku": "98542ea5-499d-45d5-aeee-c88e05d1e84c", "quantity": 1 } ] }'{ "status": true, "data": { "reservationToken": "a073da65-8d06-4ab3-b7b2-54d6b28b52d6", "quoteReference": "string", "total": 0, "totalFees": 0, "discount": 0, "promoCode": "string", "items": [ { "sku": "98542ea5-499d-45d5-aeee-c88e05d1e84c", "quantity": 0, "price": 0, "fee": 0 } ], "clientExpiresAt": "2019-08-24T14:15:22Z" }}List an event's tickets GET
Lists the purchasable ticket types for an event, ordered by their display position.
Release a reservation DELETE
Releases a held reservation, freeing the stock. Echo the `reservationToken` as the `X-Device-ID` header. If omitted, the server falls back to the reservation held for your client IP + event (the same fallback used when reserving without a token). Returns `400` if neither a token nor a matching anonymous reservation is found.