Venues

List venues with cursor-based pagination

Changed on

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

get/venues

Request

  • Base URL: https://api.session.services
  • URL: https://api.session.services/venues
  • Auth: API key in header x-tenant-id

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

OK

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-10-17T08:46:46.696Z",
        "updatedAt": "2026-10-17T08:46:46.696Z",
        "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
}

Changes

  • 84f157e4443aRevision changes
    • breaking

      the // response property's maxLength was unset from 500 for the response status

    • info

      added the non-success response with the status

  • a50002a612e2Revision changes
    • warning

      for the query request parameter cursor, the maxLength was set to 768

    • warning

      for the query request parameter query, the maxLength was set to 120

    • warning

      for the query request parameter teamId, the maxLength was set to 128