Overview

• Read-only. The Discovery API has no writes. Every operation in this plugin is a read; nothing here can change an event, a venue or a ticket.
• The key travels in the query string. Ticketmaster takes it as ?apikey=..., not as an Authorization header. A missing or wrong key answers 401 oauth.v2.InvalidApiKey.
• Paging is 0-based. page: 0 is the first page, and size defaults to 20. Each search returns next_page, which is null past the deep-paging limit.
• Deep paging stops at 1,000 items. Ticketmaster rejects a request whose size * page reaches 1,000 with DIS1035. The input schemas reject such a page before it is sent; narrow the search instead of paging further.
• An empty page has no _embedded key. Ticketmaster answers 200 and simply omits _embedded when a page has no results, including the last page of a set whose totalPages counts one too many. The searches read that as an empty list.
• totalElements can exceed what is reachable. Past 1,000 items the count keeps climbing while paging does not, so next_page is the honest signal.
• The unit and source parameters are strings. includeTBA, includeTBD, includeTest and includeFamily take 'yes' | 'no' | 'only', not booleans, and the plugin keeps that spelling.
• Rate limits. 5 requests a second and 5,000 a day for a default key. The plugin retries a 429 up to three times, honouring Retry-After.
• suggest.get returns collections, not a string. Its docs say “schema (string)”, but the live endpoint answers the same _embedded envelope as the searches, so suggest.get returns attractions, events, venues and products lists. Any of them may be empty.
• Webhooks. Ticketmaster does not send any; this plugin registers none.

• 10 typed API operations

​

Setup

npm install corsair better-sqlite3 @corsair-dev/ticketmaster

yarn add corsair better-sqlite3 @corsair-dev/ticketmaster

pnpm install corsair better-sqlite3 @corsair-dev/ticketmaster

bun add corsair better-sqlite3 @corsair-dev/ticketmaster

import Database from 'better-sqlite3';
import { createCorsair } from 'corsair';
import { ticketmaster } from '@corsair-dev/ticketmaster';

export const corsair = createCorsair({
	plugins: [
		ticketmaster(),
	],
	database: new Database('corsair.db'),
	kek: process.env.CORSAIR_KEK!,
	hub: {
		projectApiKey: process.env.CORSAIR_API_KEY!,
		signingSecret: process.env.CORSAIR_SIGNING_SECRET!,
	},
});

ticketmaster()

const { connectUrl } = await corsair.manage.connect.createLink({
	plugin: 'ticketmaster',
	tenantId: 'acme',
});
// redirect the user's browser to connectUrl

​

Example API calls

const tenant = corsair.withTenant('acme');
await tenant.ticketmaster.api.events.search({
	classificationName: ['music'],
	countryCode: 'US',
	size: 10,
});

const tenant = corsair.withTenant('acme');
await tenant.ticketmaster.api.venues.get({ id: 'KovZpZA7AAEA' });

​

What’s next