v11

latestOpenAPI 3.1.12026-08-03174162.0 MB

Venues

List venues with cursor-based pagination

Returns venues with cursor pagination. Supports filtering by team, location-based search, and text query

get/venues

Query parameters

teamIdstring

Filter venues by owner team ID

approval'PENDING' | 'APPROVED' | 'REJECTED'

Filter venues by approval status. PENDING: awaiting review, APPROVED: can be used for events, REJECTED: cannot be used

querystring

Optional search query for filtering venues by name or slug

latitudenumber

Latitude for location-based search. Must be used with longitude

longitudenumber

Longitude for location-based search. Must be used with latitude

radiusnumber

Search radius in kilometers (1-20000). Requires latitude and longitude

sort'createdAt'

Optional list sort field. Use createdAt to return newest or oldest venues first.

Example:createdAt

direction'asc' | 'desc'

Sort direction for venue lists. Defaults to desc when sort is provided.

Example:desc

limitinteger

Maximum number of venues to return per request (1-100, default: 20)

Example:20

cursorstring

Pagination cursor from previous response. Used to fetch next page of results

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

{
  "venues": [
    {
      "locationId": "loc_01h2xk3j9k8m2n5p7q9r1s3t4v",
      "googlePlaceId": "ChIJP3Sa8ziYEmsRUKgyFmh9AQM",
      "approval": "APPROVED",
      "image": {
        "src": "https://assets.session.services/my-image.jpg",
        "alt": "My Image",
        "width": 1080,
        "height": 1080
      },
      "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
        }
      }
    }
  ],
  "before": "eyJ2ZXJzaW9uIjoxLCJpbnRlbnQiOnsic291cmNlIjoiZGVtbyJ9LCJwb3MiOnsicHJpbWFyeUtleSI6InBybV8wMXM4NTNqIn19",
  "after": "eyJ2ZXJzaW9uIjoxLCJpbnRlbnQiOnsic291cmNlIjoiZGVtbyJ9LCJwb3MiOnsicHJpbWFyeUtleSI6InBybV8wMXM4NTNkIn19",
  "limit": 20
}