Backstage API

The Backstage API is Ticketlayer's primary API for event management, ticketing, venues, and organisation management. It powers the Manage app and is used for all backend integrations.

Authentication#

All API requests require authentication using a Bearer token. Include your access token in the Authorization header:

Authorization: Bearer YOUR_ACCESS_TOKEN

Most endpoints also require the X-Ticketlayer-Org header to specify which organisation you're operating on. A sales channel is a filter on the ordinary resources, not a resource of its own: a credential that names an organisation but no channel (a staff token, an organisation API key, a device) sends X-Ticketlayer-Channel: <slug> where a call sells through one, and a channel key names its channel itself. GET /events with a channel returns what that channel sells; POST /cart requires one.

The tutorial that walks through a first call is Your first API call; which credential to use where is Keys and authentication. A staff access token comes from the identity issuer through OAuth, as Staff tokens describes.

SDKs#

We provide official SDKs for:

• Backstage SDK (TypeScript/JavaScript)

The code examples in this documentation show usage for both direct API calls and SDK methods.