Skip to main content

Live API

The Live API is Ticketlayer's customer-facing commerce API. It powers the Hosted Box Office, embedded Elements, and any site selling tickets through the @ticketlayer/live SDK.

It combines two things:

  • Live-only endpoints - /session and /queue - that exist only on this surface.
  • The sales surface - the /sales/* endpoints (carts, checkout, customer tokens, my-orders, themes) mirrored from the Backstage API's low-trust sales surface.

Authentication​

The Live API is a low-trust surface authenticated with a channel publishable key (tlpk_…) and a session, never a staff access token. Bootstrap a session with createLiveSession; customer-scoped actions then use a customer token minted from that session.

Versioning​

The Live API forwards the Backstage API's single dated-version timeline - see API versions. Pin behaviour with the TL-Version header.

SDKs​

The code examples show both direct API calls and SDK methods.