Skip to main content

List Venues

GET/venues
Get all the venues in your organisation. Venues are the physical locations where your events happen-theatres, stadiums, conference centres, etc. Each venue can have multiple seating layouts for different configurations. Returns basic venue info including name, address, and capacity.

When to use this

  • Populating a venue selector when creating events
  • Displaying a list of your locations
  • Finding venues by name or location

Parameters

searchquery
string

Search venues by name

statusquery
string

Filter by venue status

accountIdquery
string

Filter by account ID

pagequery
string

Page number

limitquery
string

Items per page (max 100)

Response

Venues retrieved successfully

Notes

💡Use the `expand` parameter to include venue layouts in the response if you need them.
Code Samples

List Venues using the TypeScript SDK:

import { BackstageClient } from '@ticketlayer/backstage';

const client = new BackstageClient({
  organisationSlug: 'your-org',
});
client.setAccessToken('YOUR_ACCESS_TOKEN');

// List venues
const { venues, pagination } = await client.venues.list({
  limit: 20,
  page: 1,
});

for (const item of venues) {
  console.log(`${item.id}: ${item.name || item.id}`);
}

console.log(`Page ${pagination.page} of ${pagination.totalPages}`);

Try It

Query Parameters
Search venues by name
Filter by venue status
Filter by account ID
Page number
Items per page (max 100)

Related

GETGet VenuePOSTCreate VenueGETList Venue Layouts