Sign in

v11

latestOpenAPI 3.1.12026-08-03174162.0 MB
Events

List event slugs

List current event slugs with the same filters and access rules as event lists. Supports skip/limit pagination for sitemap generation.

get/events/slugs

Query parameters

status'UPCOMING' | 'ENDED'

Filter events by their current lifecycle status

Example:UPCOMING
approval'PENDING' | 'APPROVED' | 'REJECTED'

Filter events by their approval status

Example:APPROVED
visibility'PUBLIC' | 'PRIVATE' | 'SCHEDULED' | 'PASSCODE'

Filter events by their visibility setting

Example:PUBLIC
promoterIdstring

Filter events to only those belonging to a specific promoter. If not provided, returns events from all promoters the user has access to

Example:pmt_01jqpjksnsen9vprw95et60t2m
teamIdstring

Filter events to only those belonging to a specific team. If not provided, returns events from all teams the user has access to

venueIdstring

Filter events to only those at a specific venue. If not provided, returns events at all venues

querystring

Search term to filter events by name, description, or location. Triggers full‑text search when provided

Example:Test Event
latitudenumber

Latitude coordinate for geographic search. Provide with longitude (and optional radius)

Example:-33.8944593
longitudenumber

Longitude coordinate for geographic search. Provide with latitude (and optional radius)

Example:151.2252255
radiusnumber

Search radius in kilometers from the provided coordinates. Defaults to 20km

Example:20
countrystring

Filter by country region slug. Matches events where location.country equals the region name

Example:australia
statestring

Filter by state/province region slug. Matches events where location.state equals the region name

Example:nsw
citystring

Filter by city region slug. Matches events where location.city equals the region name

Example:sydney
fromstring date

Filter events that start on or after this date (YYYY-MM-DD format). Events with entryStartsAt >= from

Example:2024-01-01
tostring date

Filter events that start on or before this date (YYYY-MM-DD format). Events with entryStartsAt <= to

Example:2024-12-31
sort'entryStartsAt' | 'createdAt'

Optional list sort field. Defaults to event start time. Use createdAt to return newest or oldest events first.

Example:createdAt
direction'asc' | 'desc'

Sort direction for event lists. Defaults to lifecycle-aware event start order unless sort is provided.

Example:desc
genresstring[]

Filter events by music genre(s). Returns events matching ANY of the provided genres (OR logic). Maximum 20 genres

[
  "Tech House",
  "Melodic Techno"
]
categoriesstring[]

Filter events by category(s). Returns events matching ANY of the provided categories (OR logic). Maximum 10 categories

[
  "Day Party",
  "Open Air"
]
featuredboolean

Filter to only featured (editorial pick) events

Example:true
limitinteger

Maximum number of event slugs to return. Must be between 1 and 1000, defaults to 1000

Example:1000
skipinteger

Number of matching event slugs to skip before returning results

Response

OK

slugsstring[] required

Current event slugs for the matching event list

skipinteger required

Number of matching event slugs skipped

limitinteger required

Maximum number of event slugs returned

Example response

{
  "limit": 1000
}