v11

latestOpenAPI 3.1.12026-08-03174162.0 MB

Events

List events

List events with filters for status, approval, visibility, and promoter. Supports full‑text search (query), geo search (latitude/longitude/radius), and cursor-based pagination.

get/events

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

limitnumber

Maximum number of events to return in each result set. Must be between 1 and 100, defaults to 20

Example:20

cursorstring

Cursor token for pagination. Provide the cursor from the previous response to continue fetching results

Example:evt_01jps5cgsenjrazw6wswmyspa3

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

Response

beforestring nullable

Cursor for navigating backward in the result set. Omitted when there are no prior results.

afterstring nullable

Cursor for navigating forward in the result set. Omitted when there are no subsequent results.

limitnumber required

Maximum number of items to return in each result set

Example response

{
  "events": [
    {
      "id": "evt_01jps5cgsenjrazw6wswmyspa3",
      "createdAt": "2026-08-03T06:13:52.214Z",
      "updatedAt": "2026-08-03T06:13:52.214Z",
      "name": "Test Event",
      "slug": "test-event",
      "description": "This is only a test...",
      "approval": "APPROVED",
      "status": "UPCOMING",
      "visibility": "PUBLIC",
      "currency": "AUD",
      "url": "https://example.com",
      "entryStartsAt": "2026-08-04T06:13:52",
      "entryEndsAt": "2026-08-05T06:13:52",
      "publishAt": "2026-08-03T06:13:52",
      "images": {
        "mobile": {
          "src": "https://assets.session.services/my-image.jpg",
          "alt": "My Image",
          "width": 1080,
          "height": 1080
        },
        "desktop": {
          "src": "https://assets.session.services/my-image.jpg",
          "alt": "My Image",
          "width": 1080,
          "height": 1080
        }
      },
      "geohash": "r3gx1",
      "location": {
        "id": "loc_01hk153x00eh99pagyydz03sbz",
        "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
        "createdAt": "2026-08-03T06:13:52.214Z",
        "updatedAt": "2026-08-03T06:13:52.214Z",
        "name": "Watson's EQ",
        "address": "The, Entertainment Quarter, 1 Bent St, Moore Park NSW 2021, Australia",
        "city": "Moore Park",
        "state": "New South Wales",
        "postcode": "2021",
        "country": "Australia",
        "latitude": -33.8944593,
        "longitude": 151.2252255,
        "timeZone": "Australia/Sydney",
        "types": [
          "establishment",
          "point_of_interest",
          "stadium"
        ],
        "description": "Historic outdoor amphitheater known for summer concerts",
        "image": {
          "src": "https://assets.session.services/my-image.jpg",
          "alt": "My Image",
          "width": 1080,
          "height": 1080
        },
        "venue": {
          "image": {
            "src": "https://assets.session.services/my-image.jpg",
            "alt": "My Image",
            "width": 1080,
            "height": 1080
          }
        }
      },
      "promoterId": "pmt_01jqpjksnsen9vprw95et60t2m",
      "genres": [
        "Tech House",
        "Melodic Techno"
      ],
      "categories": [
        "Day Party",
        "Open Air",
        "Free Entry"
      ],
      "featured": true,
      "likes": 42,
      "liked": true,
      "price": {
        "base": 1000,
        "booking": 200,
        "currency": "AUD"
      }
    }
  ],
  "before": "eyJ2ZXJzaW9uIjoxLCJpbnRlbnQiOnsic291cmNlIjoiZGVtbyJ9LCJwb3MiOnsicHJpbWFyeUtleSI6InBybV8wMXM4NTNqIn19",
  "after": "eyJ2ZXJzaW9uIjoxLCJpbnRlbnQiOnsic291cmNlIjoiZGVtbyJ9LCJwb3MiOnsicHJpbWFyeUtleSI6InBybV8wMXM4NTNkIn19",
  "limit": 20
}