Jetron TicketFluid
Events

List events

GET
/events

Lists the API key host's public events, newest first, with cursor pagination.

Authorization

ApiKeyAuth
AuthorizationBearer <token>

Your public API key (e.g. jt_public_...) passed as a Bearer token.

In: header

Query Parameters

category?string

Filter events by category slug.

q?string

Full-text search query.

limit?integer

Page size (1–100).

Range1 <= value <= 100
Default20
cursor?string

Opaque pagination cursor returned as nextCursor.

Header Parameters

If-None-Match?string

An ETag from a previous response. Returns 304 if unchanged.

Response Body

application/json

application/json

curl -X GET "https://example.com/events"
{  "status": true,  "data": {    "items": [      {        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",        "name": "string",        "slug": "string",        "posterImageURL": "string",        "posterAspectRatio": 0,        "category": {          "name": "string",          "slug": "string"        },        "cheapestTicketPrice": 0,        "formattedCheapestPrice": "string",        "description": "string",        "previewDescription": "string",        "date": "2019-08-24T14:15:22Z",        "closingDate": "2019-08-24T14:15:22Z",        "timezone": "string",        "status": "LIVE",        "isComingSoon": true,        "instagram": "string",        "website": "string",        "xAccount": "string",        "country": "NIGERIA",        "state": "string",        "lga": "string",        "street": "string",        "directions": "string",        "lng": 0,        "lat": 0,        "hideLocation": true,        "hostMessage": "string",        "createdAt": "2019-08-24T14:15:22Z"      }    ],    "nextCursor": "string"  }}

Health check GET

Readiness probe. Postgres and Redis are hard dependencies. The service reports `503` if either is unreachable. Meilisearch, RabbitMQ, Neo4j and MongoDB are reported for observability but do not affect the status code.

Get an event GET

Fetches a single public event by its slug, scoped to the API key host.