Public API endpoints
These endpoints are open — no authentication required. They let you build your own ticketing flow: display events, show ticket types, manage a shopping cart, and create an order that redirects the user to the payment provider.
Typical workflow
- Pick an event:
GET /events→ choose asub_eventfrom the returned list. - Pick a ticket type:
GET /tickettypes/:event_id→ choose adiscount_id. - Create a cart:
POST /cart/→ you get acart_id. - Add seats:
POST /cart/:cart_idwithevent_id,numberoftickets,discount_id. - Create the order:
POST /order/createwith the cart and customer details → you get a payment URL. - Redirect the user to the payment URL.
- Check status after payment:
GET /order/:order_key.
Endpoints
| Step | Endpoint | Doc |
|---|---|---|
| 1 | GET /v1/:client/events[/:id] | Events |
| 2 | GET /v1/:client/tickettypes/:event_id | Ticket types |
| 3 | POST /v1/:client/cart/ | Cart |
| 4 | POST /v1/:client/cart/:cart_id | Cart |
| 5 | POST /v1/:client/order/create | Order |
| 7 | GET /v1/:client/order/:order_key | Order |
Privacy note
Public endpoints obfuscate sensitive information. The reported event_free capacity is always the maximum number of tickets allowed per order (with offline-reserved tickets taken into account) — never the actual number sold or remaining.
Rate limits
Be respectful with requests:
- Cache event lists for at least a few minutes on your side.
- Don't poll the cart on a timer — only query when the user interacts.
- If you anticipate very high traffic (e.g. major on-sale), let us know in advance.
See also: API overview · Peppered endpoints (authenticated)