{"openapi":"3.1.0","info":{"title":"Ticketmaster (BYOK) API","version":"0.1.0","description":"Ticketmaster (BYOK) lets an AI assistant read your own Ticketmaster data through the Ticketmaster API with a key you supply (Ticketmaster consumer key). Read-only: 8 tools (search_events, get_event, search_attractions, get_attraction, search_venues, get_venue, list_classifications, suggest). The BYOK key travels with each request, is used for that one call only and is never stored, logged or...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-ticketmaster.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-ticketmaster/docs"},"termsOfService":"https://connectorbay.com/byok-ticketmaster/terms"},"servers":[{"url":"https://byok-ticketmaster.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-ticketmaster/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_events":{"post":{"operationId":"search_events","summary":"Search events (concerts, sports, arts, family) by keyword, city, country, date range, venue, attraction or category. Fre","description":"Search events (concerts, sports, arts, family) by keyword, city, country, date range, venue, attraction or category. Free plan: 5000 calls a day. Use for \"What rock concerts are on in New York in November 2026\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Words to search for in event names, for example 'Taylor Swift'.","title":"Keyword"},"city":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"City name, for example 'New York'.","title":"City"},"state_code":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"US or Canadian state or province code such as 'NY'.","title":"State Code"},"country_code":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter country code such as 'US', 'CA', 'GB' or 'AU'.","title":"Country Code"},"postal_code":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"Postal or ZIP code.","title":"Postal Code"},"classification_name":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Category name: a segment, genre or sub-genre such as 'music', 'sports', 'rock' or 'theatre'.","title":"Classification Name"},"start_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only events starting after this UTC time, format 2026-11-01T00:00:00Z.","title":"Start Date Time"},"end_date_time":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only events starting before this UTC time, format 2026-11-30T23:59:59Z.","title":"End Date Time"},"venue_id":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only events at this venue ID (from search_venues).","title":"Venue Id"},"attraction_id":{"anyOf":[{"maxLength":40,"type":"string"},{"type":"null"}],"default":null,"description":"Only events of this attraction (artist, team or show) ID (from search_attractions).","title":"Attraction Id"},"sort":{"anyOf":[{"enum":["name,asc","name,desc","date,asc","date,desc","relevance,asc","relevance,desc","distance,asc","onSaleStartDate,asc","venueName,asc","venueName,desc","random"],"type":"string"},{"type":"null"}],"default":"relevance,desc","description":"Order of results.","title":"Sort"},"size":{"anyOf":[{"maximum":8,"minimum":1,"type":"integer"},{"type":"null"}],"default":5,"description":"Results per page (1 to 8; kept small because every record is large). Size times page must stay under 1000.","title":"Size"},"page":{"anyOf":[{"maximum":199,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Zero-based page number.","title":"Page"},"locale":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Locale such as 'en-us' (default 'en').","title":"Locale"}},"title":"search_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_event":{"post":{"operationId":"get_event","summary":"Get one event by ID: name, dates and status, price ranges, notes, classifications, sale periods, venue and attractions, ","description":"Get one event by ID: name, dates and status, price ranges, notes, classifications, sale periods, venue and attractions, and the ticket page URL. Use for \"Show details and prices of Ticketmaster event G5diZfkn0B-bh\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"event_id":{"description":"Event ID from search_events, for example 'G5diZfkn0B-bh'.","maxLength":40,"title":"Event Id","type":"string"},"locale":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Locale such as 'en-us' (default 'en').","title":"Locale"}},"required":["event_id"],"title":"get_eventArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_attractions":{"post":{"operationId":"search_attractions","summary":"Search attractions (artists, teams, shows) by keyword or category, with category and upcoming-event counts. Use for \"Fin","description":"Search attractions (artists, teams, shows) by keyword or category, with category and upcoming-event counts. Use for \"Find the Ticketmaster attraction for the band Radiohead\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Words to search for in attraction names, for example 'Radiohead'.","title":"Keyword"},"classification_name":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Category name such as 'music', 'sports' or 'rock'.","title":"Classification Name"},"sort":{"anyOf":[{"enum":["name,asc","name,desc","relevance,asc","relevance,desc","random"],"type":"string"},{"type":"null"}],"default":"relevance,desc","description":"Order of results.","title":"Sort"},"size":{"anyOf":[{"maximum":8,"minimum":1,"type":"integer"},{"type":"null"}],"default":5,"description":"Results per page (1 to 8; kept small because every record is large). Size times page must stay under 1000.","title":"Size"},"page":{"anyOf":[{"maximum":199,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Zero-based page number.","title":"Page"},"locale":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Locale such as 'en-us' (default 'en').","title":"Locale"}},"title":"search_attractionsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_attraction":{"post":{"operationId":"get_attraction","summary":"Get one attraction by ID: name, categories, links and the number of upcoming events. Use for \"How many upcoming events d","description":"Get one attraction by ID: name, categories, links and the number of upcoming events. Use for \"How many upcoming events does Ticketmaster attraction K8vZ91713wV have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"attraction_id":{"description":"Attraction ID from search_attractions.","maxLength":40,"title":"Attraction Id","type":"string"},"locale":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Locale such as 'en-us' (default 'en').","title":"Locale"}},"required":["attraction_id"],"title":"get_attractionArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_venues":{"post":{"operationId":"search_venues","summary":"Search venues by keyword, location or country, with address, city and coordinates. Use for \"Find venues called Madison S","description":"Search venues by keyword, location or country, with address, city and coordinates. Use for \"Find venues called Madison Square Garden on Ticketmaster\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Words to search for in venue names, for example 'Madison Square Garden'.","title":"Keyword"},"state_code":{"anyOf":[{"maxLength":3,"type":"string"},{"type":"null"}],"default":null,"description":"US or Canadian state or province code such as 'NY'.","title":"State Code"},"country_code":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter country code such as 'US'.","title":"Country Code"},"sort":{"anyOf":[{"enum":["name,asc","name,desc","relevance,asc","relevance,desc","random"],"type":"string"},{"type":"null"}],"default":"relevance,desc","description":"Order of results.","title":"Sort"},"size":{"anyOf":[{"maximum":8,"minimum":1,"type":"integer"},{"type":"null"}],"default":5,"description":"Results per page (1 to 8; kept small because every record is large). Size times page must stay under 1000.","title":"Size"},"page":{"anyOf":[{"maximum":199,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Zero-based page number.","title":"Page"},"locale":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Locale such as 'en-us' (default 'en').","title":"Locale"}},"title":"search_venuesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/get_venue":{"post":{"operationId":"get_venue","summary":"Get one venue by ID: address, coordinates, time zone, parking and accessibility notes and upcoming event count. Use for ","description":"Get one venue by ID: address, coordinates, time zone, parking and accessibility notes and upcoming event count. Use for \"Where is Ticketmaster venue KovZpZA7AAEA and what are its access notes\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"venue_id":{"description":"Venue ID from search_venues.","maxLength":40,"title":"Venue Id","type":"string"},"locale":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Locale such as 'en-us' (default 'en').","title":"Locale"}},"required":["venue_id"],"title":"get_venueArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_classifications":{"post":{"operationId":"list_classifications","summary":"List event categories: segments (Music, Sports, Arts and Theatre ...) with their genres and IDs, usable as classificatio","description":"List event categories: segments (Music, Sports, Arts and Theatre ...) with their genres and IDs, usable as classification filters. Use for \"What event categories does Ticketmaster have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Words to search for in category names, for example 'jazz'.","title":"Keyword"},"size":{"anyOf":[{"maximum":20,"minimum":1,"type":"integer"},{"type":"null"}],"default":5,"description":"Results per page (1 to 20; kept small because every record is large). Size times page must stay under 1000.","title":"Size"},"page":{"anyOf":[{"maximum":199,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Zero-based page number.","title":"Page"},"locale":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Locale such as 'en-us' (default 'en').","title":"Locale"}},"title":"list_classificationsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/suggest":{"post":{"operationId":"suggest","summary":"Get search suggestions across events, attractions and venues for a short text, for autocomplete. The documentation does ","description":"Get search suggestions across events, attractions and venues for a short text, for autocomplete. The documentation does not list the response fields, so the answer is passed through (capped). Use for \"Suggest Ticketmaster results for 'coldp'\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"keyword":{"description":"Text typed so far, for example 'coldp'.","maxLength":100,"title":"Keyword","type":"string"},"country_code":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter country code to limit suggestions.","title":"Country Code"},"size":{"anyOf":[{"maximum":10,"minimum":1,"type":"integer"},{"type":"null"}],"default":5,"description":"Results per page (1 to 10; kept small because every record is large). Size times page must stay under 1000.","title":"Size"},"locale":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Locale such as 'en-us' (default 'en').","title":"Locale"}},"required":["keyword"],"title":"suggestArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}