# Ticketmaster

Ticketmaster provides APIs for event discovery, inventory management, and ticketing solutions.

- **Category:** event management
- **Auth:** API_KEY, OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 15
- **Triggers:** 0
- **Slug:** `TICKETMASTER`
- **Version:** 20260312_00

## Tools

### Execute Season Ticketing Command

**Slug:** `TICKETMASTER_EXECUTE_SEASON_TICKETING_COMMAND`

Tool to execute Season Ticketing API commands for ticket management operations. Use when you need to interact with Ticketmaster's Archtics Season Ticketing system for administrative tasks, account management, or event discovery. Supports commands: ping (test connectivity), customer_query (get account info), seats_sold (retrieve sold seat details), event_search (search events), event_details (get event attributes), get_attendance (retrieve attendance data). Note: API may return 202 ACCEPTED for asynchronous operations - caller must poll with provided cookies until receiving 200 OK response.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `header` | object | Yes | Header containing version, source system type, system name, and Archtics version |
| `command` | object | Yes | Command details including cmd type, user id, dsn, and optional additional parameters |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Attraction Details V2

**Slug:** `TICKETMASTER_GET_ATTRACTION_DETAILS2`

Tool to retrieve detailed information about a specific attraction by ID from Ticketmaster Discovery API v2. Use when you need attraction details with optional licensed content filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the attraction |
| `locale` | string | No | The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*') |
| `includeLicensedContent` | string ("yes" | "no") | No | True if you want to display licensed content |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Ticketmaster Attractions

**Slug:** `TICKETMASTER_GET_ATTRACTIONS`

Tool to retrieve a list of attractions. Use when you need to search for artists, teams, or performers by various criteria such as keyword, classification, or country.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number (zero-based). |
| `size` | integer | No | Number of results per page (1–200). |
| `sort` | string | No | Sorting of results. Common values: 'name,asc', 'name,desc'. |
| `type` | string | No | Entity type filter (e.g., event, venue, attraction). |
| `source` | string | No | Content source. One of: ticketmaster, universe, frontgate. |
| `genreId` | string | No | Genre identifier. |
| `keyword` | string | No | Search term to find attractions by name, genre, etc. |
| `segmentId` | string | No | Segment identifier. |
| `subGenreId` | string | No | Subgenre identifier. |
| `countryCode` | string | No | 2-letter country code (ISO 3166-1 alpha-2). |
| `includeTest` | boolean | No | If true, include test attractions in the response. |
| `attractionId` | string | No | Specific Ticketmaster attraction ID to retrieve one attraction. |
| `subSegmentId` | string | No | Sub-segment identifier. |
| `classificationName` | string | No | Filter by classification name (e.g., music, sports). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Classification Details

**Slug:** `TICKETMASTER_GET_CLASSIFICATION_DETAILS`

Tool to retrieve detailed information about a specific classification. Use after obtaining a classification ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the classification (segment, genre, subgenre, type, or subtype) to retrieve detailed information about |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Classifications

**Slug:** `TICKETMASTER_GET_CLASSIFICATIONS`

Retrieves event classifications from Ticketmaster's Discovery API. Classifications provide a hierarchical taxonomy for categorizing events: - Segment: Top-level category (Music, Sports, Arts & Theater, Family, Film, Miscellaneous) - Genre: Secondary category within a segment (e.g., Rock, Baseball, Comedy) - Subgenre: Tertiary category for specific classification (e.g., Alternative Rock, MLB) Use this tool to discover available categories before searching for events, or to understand how events are organized in the Ticketmaster system. The classifications can be filtered by locale, country, or specific classification ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `locale` | string | No | The locale in ISO code format (e.g., 'en-us' for US English, 'es-mx' for Mexican Spanish). Controls the language of classification names returned. |
| `countryCode` | string | No | Filter classifications by ISO 3166-1 alpha-2 country code (e.g., 'US' for United States, 'CA' for Canada). Returns classifications relevant to the specified country. |
| `classificationId` | string | No | Filter to retrieve a specific classification by its unique ID. Use this to get details about a particular segment, genre, or subgenre. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Details

**Slug:** `TICKETMASTER_GET_EVENT_DETAILS`

Tool to retrieve detailed information about a specific event by ID. Use when you have an event's unique identifier and need its full details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the event to retrieve details for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Images

**Slug:** `TICKETMASTER_GET_EVENT_IMAGES`

Tool to retrieve images for a specific event by ID. Use when you need to fetch image URLs and metadata for an event.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the event to retrieve images for |
| `locale` | string | No | The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*') |
| `includeLicensedContent` | string ("yes" | "no") | No | Whether to include licensed content in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Search Events

**Slug:** `TICKETMASTER_GET_EVENTS`

Search for events on Ticketmaster using various filters including location, date range, keywords, classifications, and more. This action queries the Ticketmaster Discovery API to find events matching your criteria. Results are paginated and can be sorted. Use this when you need to: search for concerts/shows/games, find events in a specific location, filter by date range, or discover events by artist/venue. Key capabilities: - Location search: by city, state, postal code, lat/long, or radius - Time filtering: events within date ranges or on-sale dates - Classification: filter by segment (Music/Sports/Arts), genre, subgenre - Keyword search: find events by name or description - Venue/Attraction: get events at specific venues or by specific artists/teams Note: Deep paging limit - size * page must be < 1000. Maximum 200 results per page.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Filter by specific event ID |
| `city` | string | No | Filter by city name (e.g., 'Los Angeles', 'New York') |
| `page` | integer | No | Page number (0-indexed). Default: 0. Note: size * page must be < 1000 due to deep paging limits |
| `size` | integer | No | Number of results per page (1-200). Default: 20. Note: size * page must be < 1000 due to deep paging limits |
| `sort` | string | No | Sort order for results. Format: 'field,direction' (e.g., 'date,asc', 'name,desc', 'relevance,desc'). Default: 'relevance,desc' |
| `unit` | string ("miles" | "km") | No | Unit of measurement for radius search |
| `dmaId` | string | No | Filter by DMA (Designated Market Area) ID(s). Comma-separated for multiple |
| `locale` | string | No | Locale for localized content in ISO format (e.g., 'en-us'). Comma-separated for multiple. Default: 'en' |
| `radius` | integer | No | Radius of search area around latlong or postalCode (use with 'unit' parameter) |
| `source` | string | No | Filter by source name (e.g., 'ticketmaster', 'universe', 'frontgate', 'tmr') |
| `typeId` | string | No | Filter by event type ID(s). Comma-separated for multiple |
| `genreId` | string | No | Filter by genre ID(s). Comma-separated for multiple |
| `keyword` | string | No | Keyword to search for in event names, descriptions, or attractions (e.g., 'rock', 'Hamilton') |
| `latlong` | string | No | Geolocation filter as 'latitude,longitude' (use with radius and unit) |
| `venueId` | string | No | Filter by venue ID(s). Comma-separated for multiple |
| `geoPoint` | string | No | Filter events by geohash (alternative to latlong) |
| `marketId` | string | No | Filter by Ticketmaster market ID |
| `segmentId` | string | No | Filter by segment ID(s) - highest classification level (Music, Sports, Arts & Theatre, etc.). Comma-separated for multiple |
| `stateCode` | string | No | Filter by US state code (2-letter abbreviation) |
| `subTypeId` | string | No | Filter by event subtype ID(s). Comma-separated for multiple |
| `postalCode` | string | No | Filter events by postal code or zipcode |
| `promoterId` | string | No | Filter by promoter ID |
| `subGenreId` | string | No | Filter by subgenre ID(s). Comma-separated for multiple |
| `countryCode` | string | No | Filter by ISO 3166 country code (2-letter) |
| `endDateTime` | string | No | Filter events starting on or before this date-time (ISO-8601 format with timezone) |
| `segmentName` | string | No | Filter by segment name (e.g., 'Music', 'Sports', 'Arts & Theatre') |
| `attractionId` | string | No | Filter by attraction ID(s). Comma-separated for multiple (e.g., 'K8vZ9172A1' for a specific artist/team) |
| `includeFamily` | string ("yes" | "no" | "only") | No | Filter family-friendly events. 'yes'=include all, 'no'=exclude family events, 'only'=only family events |
| `startDateTime` | string | No | Filter events starting on or after this date-time (ISO-8601 format with timezone, e.g., '2026-03-01T00:00:00Z') |
| `classificationId` | string | No | Filter by classification ID(s). Comma-separated for multiple. Supports negative filtering with '-' prefix |
| `includeSpellcheck` | string ("yes" | "no") | No | Include spell check suggestions for keywords. 'yes' or 'no'. Default: 'no' |
| `onsaleEndDateTime` | string | No | Filter events with onsale end date/time on or before this date (ISO-8601 format) |
| `classificationName` | string | No | Filter by classification name (segment/genre/subgenre). Supports negative filtering with '-' prefix (e.g., '-music' to exclude music) |
| `onsaleStartDateTime` | string | No | Filter events with onsale start date/time on or after this date (ISO-8601 format) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Genre Details

**Slug:** `TICKETMASTER_GET_GENRE_DETAILS`

Tool to retrieve detailed information about a specific genre. Use when you need metadata for a single genre before filtering events by genre.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the genre. Use TICKETMASTER_GET_CLASSIFICATIONS to discover valid genre IDs. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Section Map Image

**Slug:** `TICKETMASTER_GET_SECTION_MAP_IMAGE`

Tool to retrieve the section map image for an event showing venue layout. Use when you need a visual representation of a venue's seating sections for a specific event. Optionally highlights specific sections or seats.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `app` | string | No | Application context for the map rendering (e.g., TOPPICKS for highlighting top pick sections) |
| `placeId` | string | No | Specific seat or place identifier to highlight on the map |
| `event_id` | string | Yes | The unique event identifier for which to retrieve the section map image |
| `systemId` | string | No | System identifier (e.g., HOST) to specify the ticketing system context |
| `sectionNames` | string | No | Specific venue sections to highlight on the map. Comma-separated for multiple sections |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Segment Details

**Slug:** `TICKETMASTER_GET_SEGMENT_DETAILS`

Retrieve detailed information about a specific Ticketmaster event segment, including all associated genres and subgenres. Segments are the top-level classification categories for events (e.g., Music, Sports, Arts & Theatre, Family, Film, Miscellaneous). This action returns the segment's metadata along with a complete list of genres and their subgenres that fall under this segment. Use this action after obtaining a segment ID from Get Classifications or from event classification data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the segment to retrieve. Segments represent primary event categories like Music (KZFzniwnSyZfZ7v7nJ), Sports (KZFzniwnSyZfZ7v7nE), or Arts & Theatre (KZFzniwnSyZfZ7v7na). Obtain from Get Classifications or Get Events actions. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subgenre Details

**Slug:** `TICKETMASTER_GET_SUBGENRE_DETAILS`

Tool to retrieve detailed information about a specific subgenre. Use when you have a subgenre ID and need its details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier of the subgenre to retrieve |
| `locale` | string | No | Locale in which to return results (e.g., en-us) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Advanced Suggestions

**Slug:** `TICKETMASTER_GET_SUGGESTIONS2`

Get advanced auto-complete search suggestions from Ticketmaster's Discovery API. Returns matching attractions (artists, teams, performers), venues (concert halls, stadiums, theaters), and events based on search criteria with extensive filtering options. Use this when you need more control over suggestions including location filtering, source filtering, fuzzy matching, and spell checking. Perfect for implementing type-ahead search functionality with advanced filters or helping users discover entertainment options based on location, segment, and other criteria.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `size` | string | No | Size of every entity returned in the response (number of suggestions per entity type). Default: 5 |
| `unit` | string ("miles" | "km") | No | Unit of the radius. Options: miles or km. Default: miles |
| `locale` | string | No | The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*'). Default: en |
| `radius` | string | No | Radius of the area in which we want to search for events. Used with latlong or geoPoint. Default: 100 |
| `source` | string ("ticketmaster" | "universe" | "frontgate" | "tmr") | No | Filter entities by its source name. Options: ticketmaster, universe, frontgate, tmr |
| `keyword` | string | No | Keyword to search on. Use partial keywords to get auto-complete suggestions (e.g., 'rock', 'jazz', 'broadway') |
| `latlong` | string | No | Filter events by latitude and longitude (format: 'lat,long' e.g., '34.0522,-118.2437'). Note: This filter is deprecated and may be removed in a future release, please use geoPoint instead |
| `geoPoint` | string | No | Filter events by geoHash (alternative to latlong). Use this instead of deprecated latlong parameter |
| `segmentId` | string | No | Filter suggestions by segment ID (e.g., 'KZFzniwnSyZfZ7v7nJ' for Music segment) |
| `includeTBA` | string ("yes" | "no" | "only") | No | Set to 'yes' to include events with date to be announced (TBA). Default: 'no' if date parameter sent, 'yes' otherwise. Options: yes, no, only |
| `includeTBD` | string ("yes" | "no" | "only") | No | Set to 'yes' to include events with a date to be defined (TBD). Default: 'no' if date parameter sent, 'yes' otherwise. Options: yes, no, only |
| `countryCode` | string | No | Filter suggestions by country code (ISO 3166-1 alpha-2, e.g., 'US', 'CA', 'GB') |
| `includeFuzzy` | string ("yes" | "no") | No | Set to 'yes' to include fuzzy matches in the search. This has performance impact. Default: no |
| `clientVisibility` | string | No | Filter events to clientName. Use to restrict results to specific client visibility |
| `includeSpellcheck` | string ("yes" | "no") | No | Set to 'yes' to include spell check suggestions in the response. Default: no |
| `includeLicensedContent` | string ("yes" | "no") | No | Set to 'yes' if you want to display licensed content. Default: no |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Venue Details (Enhanced)

**Slug:** `TICKETMASTER_GET_VENUE_DETAILS2`

Tool to retrieve comprehensive details about a specific venue by ID. Use when you need detailed venue information including location, box office info, images, and social media data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | ID of the venue to retrieve details for |
| `locale` | string | No | The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*') |
| `includeLicensedContent` | string ("yes" | "no") | No | Enum for includeLicensedContent parameter. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Venues

**Slug:** `TICKETMASTER_GET_VENUES`

Tool to retrieve a list of venues based on specified criteria. Use when you need venue details by name, location, or ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | No | Venue ID or comma-separated list of IDs |
| `city` | string | No | Filter by city name |
| `page` | integer | No | Page number (default 0) |
| `size` | integer | No | Number of results per page (default 20, max 200) |
| `sort` | string | No | Sort order, e.g., 'name' or 'name,desc' |
| `dmaId` | string | No | Filter by DMA ID or comma-separated list of IDs |
| `radius` | integer | No | Search radius in miles |
| `keyword` | string | No | Search by venue keyword |
| `latlong` | string | No | Latitude and longitude in format 'lat,long' |
| `stateCode` | string | No | Filter by state code |
| `postalCode` | string | No | Filter by postal code (max length 16) |
| `countryCode` | string | No | Filter by 2-letter country code |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |