Skip to main content

List Venue Layouts

GET/venues/{id}/layouts
Get all the seating layouts across your venues. Returns layouts with their capacity and configuration details. Filter by venue to see just the layouts for one location. Each venue can have multiple layouts for different configurations-concerts vs theatre shows, full capacity vs socially distanced, etc.

When to use this

  • Populating a layout picker when creating an event
  • Showing all available configurations for a venue
  • Auditing seating capacity across venues

Parameters

idpathrequired
string

Venue ID

searchquery
string

Search layouts by name

statusquery
string

Filter by layout status

accountIdquery
string

Filter by account ID

pagequery
string

Page number

limitquery
string

Items per page (max 100)

Response

Venue layouts retrieved successfully

Notes

💡Filter by `venueId` to see layouts for a specific venue.
Code Samples

List Venue Layouts using the TypeScript SDK:

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

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

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

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

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

Try It

Path Parameters
Venue ID
Query Parameters
Search layouts by name
Filter by layout status
Filter by account ID
Page number
Items per page (max 100)

Related

GETGet Venue LayoutPOSTCreate Venue LayoutGETList Venues