REST API v2. Authenticate with a Bearer JWT in the Authorization header unless an endpoint is marked public.
Servers​
Box Office​
Box office cart and checkout endpoints
Operations​
Submit attendee information for a box-office order​
Submits attendee info, question answers, waiver signatures, and team assignments for a box-office order. Data is validated and stored temporarily on the cart for finalization.
Authorizations​
Request Body​
Responses​
Validated attendee data echoed back
View the active box office cart​
Add an item to the box office cart​
Remove an item from the cart​
Update quantity of a cart item​
Updates the quantity, wave time, and/or shipping method of a specific cart line. waveTimeId applies to the targeted line only. At least one of quantity or waveTimeId is required.
Authorizations​
Parameters​
Path Parameters
Request Body​
Responses​
Item updated, full cart returned
Get checkout questions for a box-office order​
Returns party member field flags, per-ticket custom questions, waivers, team config, and purchaser-level event questions for the given order.
Authorizations​
Parameters​
Path Parameters
Order GUID
"uuid"Responses​
Checkout questions payload
Check in tickets on a box-office order​
Check in one or all eligible tickets on a finalized box-office order. Returns HTTP 200 with per-ticket success/failure results (partial success allowed). Requires the order to be linked to a box-office cart for the authenticated admin.
Authorizations​
Parameters​
Path Parameters
Order id returned from checkout finalization
"int64"Request Body​
Responses​
Check-in completed; inspect results for per-ticket outcomes
Create an order from the active cart​
Creates an order from the admin's active cart. Marks the cart as "placed" and refreshes inventory hold timers. Does not start a payment — use POST /box-office/checkout after this.
Authorizations​
Responses​
Order created.
Get order summary by order GUID​
Rebuilds pricing from the cart linked to the given order GUID. Calculates all fees using box-office backend rates and returns line items + totals.
Authorizations​
Parameters​
Path Parameters
Order GUID returned from POST /box-office/orders
"uuid"Responses​
Order summary with line items and totals
Get reprint artifacts for an order​
Regenerates the Boca/thermal print artifact URLs (and order hash) for an already-finalized box-office order so operators can reprint tickets without placing a new order.
Authorizations​
Parameters​
Path Parameters
Order id returned from checkout finalization
Responses​
Print artifact URLs for the order
Apply a promo code to the cart or order​
Validates the promo code, optimizes assignment against other promos on the cart, and persists per line item. Send guid (order GUID) when the cart is linked to an order; omit guid to use the authenticated admin’s active cart. Returns 200 on success so the client can refetch cart or order summary.
Authorizations​
Request Body​
Responses​
Promo code applied
Remove a promo code from the active cart​
Remove a promo code from an order-linked cart​
Removes the specified promo code from applicable ticket holds for the cart linked to the order guid.
Authorizations​
Parameters​
Path Parameters
Order GUID
"uuid"Query Parameters
Promo code string to remove
Responses​
Promo code removed
Set purchaser for a box-office order​
Sets the purchaser for a box-office order. Use type "boxOffice" for the generic box-office user or "customer" to find/create a real customer by email.
Authorizations​
Request Body​
Responses​
Purchaser set successfully
Start payment for a box-office order​
Starts the payment process for an existing box-office order. The operator selects credit or cash on the checkout page. For credit, creates a Stripe PaymentIntent and returns the client_secret. For cash, marks the order ready for immediate verification.
Authorizations​
Request Body​
Responses​
Checkout started successfully.
Verify payment and finalize box-office order​
Verifies the payment status for a box-office order. If the payment has succeeded, finalizes the order (creates tickets, transaction, updates inventory). For cash/zero-dollar orders, finalizes immediately. The client should poll this endpoint after checkout.
Authorizations​
Request Body​
Responses​
Order finalized successfully.
Cancel box-office payment​
Cancels the Stripe PaymentIntent (if any) and resets the cart status to "placed" so the operator can modify the cart or retry checkout.
Authorizations​
Request Body​
Responses​
Payment cancelled, cart reset.