Operation
Get Venue Layout
GET
/venues/{id}/layouts/{layoutId}Fetch the full details of a seating layout.
Returns the layout with all its areas, categories, and optionally individual
seats. Use this to render a seat map or to get capacity information.
The response includes the structure of the venue: areas (like "Orchestra" or
"Balcony"), price categories, and how seats are organised.
When to use this
- Rendering a seat map for ticket selection
- Loading layout data for editing
- Getting capacity and availability information
Path parameters
idstringRequired- Venue ID
layoutIdstringRequired- Layout ID
Returns
Venue layout 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 `expand=seats` to include individual seat data (useful for seat maps, but can be a large response).
Related
import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({ organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// Get venuelayout detailsconst venuelayout = await client.venuelayout.get('{{VENUELAYOUT_ID}}');console.log(`VenueLayout: ${venuelayout.name || venuelayout.id}`);Response 200
{
"venueLayout": {
"id": "vlt_abc123",
"venueId": "vnu_def456",
"organisationId": "org_xyz789",
"accountId": "acc_ghi012",
"name": "Theatre Mode",
"description": "Standard theatre configuration",
"status": "active",
"totalCapacity": 1500,
"categories": [],
"areas": [],
"decorations": [],
"tags": [
"theatre",
"seated"
],
"isDeleted": false,
"createdAt": "2024-12-28T10:30:00Z",
"updatedAt": "2024-12-28T14:45:00Z",
"createdBy": "usr_abc123"
}
}