EventCube Storefront API
Public storefront API for EventCube stores (/api/v1/*).
Authentication
All requests require a Bearer token:
Authorization: Bearer {api_token}
Use the store's api_key or apiToken.
Store context
Requests must be sent to the store's domain (e.g. https://your-store.eventcube.io).
The store is resolved from the hostname — there is no store ID header.
Pagination
List endpoints return { "results": [...], "count": <total> }.
Use the page query parameter (default page size: 20).
Money amounts
Ticket price and booking_fee are in minor units (e.g. pence/cents).
Cart and order monetary totals are returned as strings.
Date and time
All datetimes in this API use UTC.
| Direction | Format | Notes |
|---|---|---|
Request — event start / end | Y-m-d H:i:s string | e.g. 2026-07-01 18:00:00 (UTC, no offset) |
| Request — discount / device PIN datetimes | ISO 8601 string | e.g. 2026-07-01T18:00:00Z (UTC) |
Request — cart expires_at | Unix timestamp (integer) | Seconds since epoch (UTC) |
Response — event start / end, cart expiry, audit fields | Unix timestamp (integer) | Seconds since epoch (UTC) |
Response — discount start / end | ISO 8601 string | UTC instant |
Event responses also include a timezone string — the display timezone for the event
(e.g. Europe/London). It does not change how request datetimes are interpreted.
Errors
Validation and business errors typically return:
{ "errors": { "field": ["message"] } }
Authentication
- HTTP: Bearer Auth
Store API key or apiToken
Security Scheme Type: | http |
|---|---|
HTTP Authorization Scheme: | bearer |