Operation
Get Event Occurrence
GET
/events/{eventId}/occurrences/{occurrenceId}Fetch details about a specific show date/time.
Returns everything about an occurrence: when it starts and ends, how many
tickets are available, current sales status, and links to its parent event.
Useful when you need full details about one particular performance.
When to use this
- Showing occurrence details on a booking page
- Loading data for an occurrence editor
- Checking availability before processing a ticket sale
Path parameters
eventIdstringRequired- Event ID
occurrenceIdstringRequired- Occurrence ID
Headers
X-Ticketlayer-ChannelstringOptional- Slug of the sales channel to act through. A channel-scoped credential supplies its own channel and this header, when sent, must agree with it. On a read it filters to what that channel sells, at its resolved prices; on a cart it is required; on an order operation it is derived from the order and may only confirm it, never contradict it.
Returns
Event occurrence 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
The response includes capacity and sold counts, so you can calculate remaining availability.
Related
import { BackstageClient } from '@ticketlayer/backstage';const client = new BackstageClient({ organisationSlug: 'your-org',});client.setAccessToken('YOUR_ACCESS_TOKEN');// Get eventoccurrence detailsconst eventoccurrence = await client.eventoccurrence.get('{{EVENTID}}');console.log(`EventOccurrence: ${eventoccurrence.name || eventoccurrence.id}`);Response 200
{
"eventOccurrence": {
"id": "eoc_abc123",
"organisationId": "org_xyz789",
"accountId": "acc_def456",
"eventId": "evt_ghi789",
"startDate": "2025-06-15T00:00:00Z",
"startTime": "19:00:00",
"endDate": "2025-06-15T00:00:00Z",
"endTime": "23:00:00",
"timezone": "Europe/London",
"venueId": "vnu_abc123",
"status": "draft",
"isDeleted": false,
"createdAt": "2024-12-28T10:30:00Z",
"updatedAt": "2024-12-28T14:45:00Z"
}
}