Operation
Get Venue
GET
/venues/{id}Fetch details about a specific venue.
Returns everything about the venue: name, address, capacity, and optionally
its seating layouts.
Use the `expand` parameter to include related data like layouts and areas.
When to use this
- Displaying venue information on an event page
- Loading venue data for an editor
- Getting the venue's seating layouts
Path parameters
idstringRequired- Venue ID
Returns
Venue 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
Pass `expand=layouts` to include seating layouts in the response.
Related
import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({ organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// Get venue detailsconst venue = await client.venue.get('{{VENUE_ID}}');console.log(`Venue: ${venue.name || venue.id}`);Response 200
{
"venue": {
"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"
}
}