API Reference
Base URL, authentication, and conventions for the Jetron Fluid REST API.
The Jetron Fluid REST API is served under:
https://fluid.jetronticket.com/api/v1Endpoint pages in this section are generated from the OpenAPI spec and include request/response schemas, code samples, and an interactive playground.
Authentication
All endpoints except GET /health require your public API key as a Bearer
token:
Authorization: Bearer jt_public_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxRequests are scoped to the event host that owns the key and rate limited per key. See Authentication.
Conventions
- Envelope: success responses are
{ "data": <payload>, "status": true }; errors are{ "message": string, "status": <code>, "error_code": string }. See Errors. - Money: integers in the smallest currency unit (kobo, pesewa, cents). See Money.
- Caching: event reads return
ETagand honorIf-None-Match. See Caching & ETags. X-Device-ID: the reservation token header used across the checkout endpoints. See Reservations.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /health | Health check (unauthenticated) |
| GET | /events | List events |
| GET | /events/{slug} | Get an event |
| GET | /events/{slug}/tickets | List an event's tickets |
| POST | /events/{slug}/reservations | Create or refresh a reservation |
| DELETE | /events/{slug}/reservations | Release a reservation |
| POST | /events/{slug}/orders | Create an order (checkout) |

