Public Events Feed

The events feed is a public, read-only endpoint that returns an organisation’s upcoming published events. It’s used by Drumtix’s own embeddable multi-event widget, and you can call it directly to build your own integration — no API key needed.

Endpoint

GET https://app.drumtix.com/api/widget/events/:orgSlug

:orgSlug is the organisation’s public slug — the same one used in your Shop and checkout URLs (e.g. drumtix.com/shop/your-slug).

Query parameters

Parameter	Type	Default	Description
`max`	number	`6`	Maximum number of events to return. Clamped between 1 and 20.

Response

Returns a JSON array of upcoming, published events, ordered by start date. Past, draft, and archived events are never included.

[
  {
    "slug": "friday-night-live",
    "orgSlug": "acme-nightclub",
    "title": "Friday Night Live",
    "startsAt": "2026-07-11T21:00:00.000Z",
    "endsAt": "2026-07-12T03:00:00.000Z",
    "timezone": "Europe/London",
    "venueName": "Acme Warehouse",
    "imageUrl": "https://cdn.drumtix.com/events/abc123/poster.jpg",
    "currency": "GBP",
    "lowestPriceMinor": 1500,
    "highestPriceMinor": 3000,
    "status": "available",
    "ticketUrl": "https://app.drumtix.com/e/acme-nightclub/friday-night-live"
  }
]

lowestPriceMinor / highestPriceMinor are in minor currency units (e.g. pence for GBP) and reflect only currently-available ticket tiers. Both are null if no tiers are currently available.
status is one of available, sale_ended, or sold_out.
ticketUrl links straight to the Drumtix checkout page for that event.

Example

const res = await fetch('https://app.drumtix.com/api/widget/events/acme-nightclub?max=10')
const events = await res.json()

Rate limits

This endpoint is rate-limited per IP address to keep it fair for everyone calling it. If you exceed the limit, you’ll get a 429 response with Retry-After, X-RateLimit-Limit, and X-RateLimit-Remaining headers telling you how long to wait.

Getting Started

Events

Orders & Payments

Door & Check-in

Marketing & Promoters

Widgets & Embeds

Customers & Analytics

Public Events Feed

Endpoint

Query parameters

Response

Example

Rate limits

​Endpoint

​Query parameters

​Response

​Example

​Rate limits

Endpoint

Query parameters

Response

Example

Rate limits