Operation

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

Query parameters

searchstringOptional: Search venues by name
statusstringOptional: Filter by venue status
accountIdstringOptional: Filter by account ID
pagestringOptional: Page number
limitstringOptional: Items per page (max 100)

Returns

Venues retrieved successfully

Errors

400: Bad Request - Invalid input
401: Unauthorized - Authentication required
403: Forbidden - Insufficient permissions
404: Not Found - Resource not found
500: Internal Server Error

Every error names its code and links to it. All error codes

Notes

Tip

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

import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({  organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// List venuesconst { 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}`);

Response 200

{
  "venues": [
    {
      "id": "vnu_abc123",
      "organisationId": "org_xyz789",
      "accountId": "acc_def456",
      "name": "Royal Albert Hall",
      "description": "Historic concert hall in London",
      "status": "active",
      "streetAddress": "Kensington Gore",
      "country": "United Kingdom",
      "coordinates": {
        "type": "Point",
        "coordinates": [
          -0.1278,
          51.5074
        ]
      },
      "timezone": "Europe/London",
      "phone": "+44 20 7589 8212",
      "email": "info@royalalberthall.com",
      "website": "https://www.royalalberthall.com",
      "features": [
        "parking",
        "wheelchair_accessible",
        "bar"
      ],
      "tags": [
        "concert-hall",
        "historic"
      ],
      "isDeleted": false,
      "createdAt": "2024-12-28T10:30:00Z",
      "updatedAt": "2024-12-28T14:45:00Z",
      "createdBy": "usr_abc123"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 45,
    "totalPages": 3,
    "hasNext": true,
    "hasPrev": false
  }
}

List Venues

When to use this

Query parameters

Returns

Errors

Notes

Related

Try it in test mode

Query parameters