DISCOVERY API

V 2.0

The Ticketmaster Discovery API allows you to search for events, attractions, or venues.

Overview

Authentication

To run a successful API call, you will need to pass your API Key in the apikey query parameter. Your API Key should automatically appear in all URLs throughout this portal.

Example: https://app.ticketmaster.com/discovery/v2/events.json?apikey={apikey}

Without a valid API Key, you will receive a 401 Status Code with the following response:

{
    "fault": {
        "faultstring": "Invalid ApiKey",
        "detail": {
            "errorcode": "oauth.v2.InvalidApiKey"
        }
    }
}

Root URL

https://app.ticketmaster.com/discovery/v2/

Event Sources

The API provides access to content sourced from various platform, including Ticketmaster, Universe, FrontGate Tickets and Ticketmaster Resale (TMR). By default, the API returns events from all sources. To specify a specifc source(s), use the &source= parameter. Multiple, comma separated values are OK.

Event Coverage

With over 230K+ events available in the API, coverage spans different countries, including United States, Canada, Mexico, Australia, New Zealand, United Kingdom, Ireland, other European countries, and more. More events and more countries are added on continuous basis.

event map

Examples

Get a list of all events in the United States https://app.ticketmaster.com/discovery/v2/events.json?countryCode=US&apikey={apikey}

Search for events sourced by Universe in the United States with keyword “devjam” https://app.ticketmaster.com/discovery/v2/events.json?keyword=devjam&source=universe&countryCode=US&apikey={apikey}

Search for music events in the Los Angeles area https://app.ticketmaster.com/discovery/v2/events.json?classificationName=music&dmaId=324&apikey={apikey}

Get a list of all events for Adele in Canada https://app.ticketmaster.com/discovery/v2/events.json?attractionId=K8vZ917Gku7&countryCode=CA&apikey={apikey}

V2

get /discovery/v2/suggest Find search suggestions and filter your suggestions by location, source, etc.

Default

get /discovery/v2/attractions Find attractions (artists, sports, packages, plays and so on) and filter your search by name, and much more.
get /discovery/v2/attractions/{id} Get details for a specific attraction using the unique identifier for the attraction.
get /discovery/v2/classifications Find classifications and filter your search by name, and much more. Classifications help define the nature of attractions and events.
get /discovery/v2/classifications/genres/{id} Get details for a specific genre using its unique identifier.
get /discovery/v2/classifications/segments/{id} Get details for a specific segment using its unique identifier.
get /discovery/v2/classifications/subgenres/{id} Get details for a specific sub-genre using its unique identifier.
get /discovery/v2/classifications/{id} Get details for a specific segment, genre, or sub-genre using its unique identifier.
get /discovery/v2/events Find events and filter your search by location, date, availability, and much more.
get /discovery/v2/events/{id} Get details for a specific event using the unique identifier for the event. This includes the venue and location, the attraction(s), and the Ticketmaster Website URL for purchasing tickets for the event.
get /discovery/v2/events/{id}/images Get images for a specific event using the unique identifier for the event.
get /discovery/v2/venues Find venues and filter your search by name, and much more.
get /discovery/v2/venues/{id} Get details for a specific venue using the unique identifier for the venue.

Event Search

Method: GET

Summary: Event Search

Description: Find events and filter your search by location, date, availability, and much more.

/discovery/v2/events

Query parameters:

Parameter Description Type Default Value Required
id Filter entities by its id String No
keyword Keyword to search on String No
attractionId Filter by attraction id String No
venueId Filter by venue id String No
postalCode Filter by postal code / zipcode String No
latlong Filter events by latitude and longitude, this filter is deprecated and maybe removed in a future release, please use geoPoint instead String No
radius Radius of the area in which we want to search for events. String No
unit Unit of the radius String enum:["miles", "km"] miles No
source Filter entities by its primary source name OR publishing source name String enum:["ticketmaster", " universe", " frontgate", " tmr"] No
locale 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,*') String en No
marketId Filter by market id String No
startDateTime Filter with a start date after this date String No
endDateTime Filter with a start date before this date String No
includeTBA yes, to include with date to be announce (TBA) String enum:["yes", " no", " only"] no if date parameter sent, yes otherwise No
includeTBD yes, to include with a date to be defined (TBD) String enum:["yes", " no", " only"] no if date parameter sent, yes otherwise No
includeTest True if you want to have entities flag as test in the response. Only, if you only wanted test entities String enum:["yes", " no", " only"] no No
size Page size of the response String 20 No
page Page number String 0 No
sort Sorting order of the search result. Allowable values : 'name,asc', 'name,desc', 'date,asc', 'date,desc', 'relevance,asc', 'relevance,desc', 'distance,asc', 'name,date,asc', 'name,date,desc', 'date,name,asc', 'date,name,desc','onSaleStartDate,asc', 'id,asc', 'venueName,asc', 'venueName,desc' String relevance,desc No
onsaleStartDateTime Filter with onsale start date after this date String No
onsaleEndDateTime Filter with onsale end date before this date String No
city Filter by city String No
countryCode Filter by country code String No
stateCode Filter by state code String No
classificationName Filter by classification name: name of any segment, genre, sub-genre, type, sub-type. Negative filtering is supported by using the following format '-'. Be aware that negative filters may cause decreased performance. Array No
classificationId Filter by classification id: id of any segment, genre, sub-genre, type, sub-type. Negative filtering is supported by using the following format '-'. Be aware that negative filters may cause decreased performance. Array No
dmaId Filter by dma id String No
onsaleOnStartDate Filter with onsale start date on this date String No
onsaleOnAfterStartDate Filter with onsale range within this date String No
segmentId Filter by segment id Array No
segmentName Filter by segment name String No
includeFamily Filter by classification that are family-friendly String enum:["yes", " no", " only"] yes No
promoterId Filter by promoter id String No
genreId Filter by genreId Array No
subGenreId Filter by subGenreId Array No
typeId Filter by typeId Array No
subTypeId Filter by subTypeId Array No
geoPoint filter events by geoHash String No
preferredCountry Popularity boost by country, default is us. String enum:["us", " ca"] us No
includeSpellcheck yes, to include spell check suggestions in the response. String enum:["yes", " no"] no No
domain Filter entities based on domains they are available on Array No

Response structure:

200 successful operation

  • _links(object) - links to data sets
    • self(object) - link to this data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
    • next(object) - link to the next data set
      • href(string) - reference.
      • templated(boolean) - ability to be templated
    • prev(object) - link to the previous data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
  • _embedded(object) - container
    • events(array)
      • {array item object}
        • _links(object) - links to data sets
          • self(object) - link to this data set
            • href(string) - reference
            • templated(boolean) - ability to be templated
          • venues(array) - link to this data set.
            • {array item object}
              • href(string) - reference
              • templated(boolean) - ability to be templated
          • attractions(array) - link to this data set.
            • {array item object}
              • href(string) - reference
              • templated(boolean) - ability to be templated
        • _embedded(object) - container
          • venues(array) - related
            • {array item object}
              • _links(object) - links to data sets
                • self(object) - link to this data set
                  • href(string) - reference
                  • templated(boolean) - ability to be templated
              • type (string) - Type of the entity
              • distance (number) - double
              • units (string)
              • id (string) - Unique id of the entity in the discovery API
              • locale (string) - Locale in which the content is returned
              • name (string) - Name of the entity
              • description (string) - Description's of the entity
              • address (object) - Address of the venue
                • line1 (string) - Address first line
                • line2 (string) - Address second line
                • line3 (string) - Address third line
              • city (object) - City of the venue
                • name (string) - Name of the entity
              • additionalInfo (string) - Additional information of the entity
              • state (object) - State / Province of the venue
                • stateCode (string) - State code
                • name (string) - Name of the entity
              • country (object) - Country of the venue
                • countryCode (string) - Country code (ISO 3166)
                • name (string) - Name of the entity
              • url (string) - URL of a web site detail page of the entity
              • postalCode (string) - Postal code / zipcode of the venue
              • location (object) - Location of the venue
                • longitude (number) - Longitude
                • latitude (number) - Latitude
              • timezone (string) - Timezone of the venue
              • currency (string) - Default currency of ticket prices for events in this venue
              • markets (array) - Markets of the venue
                • {array item object}
                  • id (string) - Market's id
              • images (array) - Images of the entity
                • {array item object}
                  • url (string) - Public URL of the image
                  • ratio (string) - Aspect ratio of the image
                  • width (integer) - Width of the image
                  • height (integer) - Height of the image
                  • fallback (boolean) - true if the image is not the event's image but a fallbak image
                  • attribution (string) - Attribution of the image
              • dma (array) - The list of associated DMAs (Designated Market Areas) of the venue
                • {array item object}
                  • id (integer) - DMS's id
              • social (object) - Social networks data
                • twitter (object) - Twitter data
                  • handle (string) - Twitter handle
                  • hashtags (array) - Twitter hashtags
                    • [ "string" ] - No description specified
              • boxOfficeInfo (object) - Box office informations for the venue
                • phoneNumberDetail (string) - Venue box office phone number
                • openHoursDetail (string) - Venue box office opening hours
                • acceptedPaymentDetail (string) - Venue box office accepted payment details
                • willCallDetail (string) - Venue box office will call details
              • parkingDetail (string) - Venue parking info
              • accessibleSeatingDetail (string) - Venue accessible seating detail
              • generalInfo (object) - General informations on the venue
                • generalRule (string) - Venue general rules
                • childRule (string) - Venue children rule
              • externalLinks (object) - List of external links
              • test (boolean) - Indicate if this is a test entity, by default test entities won't appear in discovery API
              • aliases (array) - List of aliases for entity
                • [ "string" ] - No description specified
              • localizedAliases (object) - List of localized aliases for entity
              • upcomingEvents (object) - number of upcoming events
              • ada (object) - ADA information
                • adaPhones (string)
                • adaCustomCopy (string)
                • adaHours (string)
          • attractions(array) - related
            • {array item object}
              • _links(object) - links to data sets
                • self(object) - link to this data set
                  • href(string) - reference
                  • templated(boolean) - ability to be templated
              • type (string) - Type of the entity
              • id (string) - Unique id of the entity in the discovery API
              • locale (string) - Locale in which the content is returned
              • name (string) - Name of the entity
              • description (string) - Description's of the entity
              • additionalInfo (string) - Additional information of the entity
              • url (string) - URL of a web site detail page of the entity
              • images (array) - Images of the entity
                • {array item object}
                  • url (string) - Public URL of the image
                  • ratio (string) - Aspect ratio of the image
                  • width (integer) - Width of the image
                  • height (integer) - Height of the image
                  • fallback (boolean) - true if the image is not the event's image but a fallbak image
                  • attribution (string) - Attribution of the image
              • classifications (array) - Attraction's classifications
                • {array item object}
                  • primary (boolean) - True if this is the entity's primary classification
                  • segment (object) - A Segment is a primary genre for an entity (Music, Sports, Arts, etc)
                    • genres (array) - List of Genre linked to the Segment
                      • {array item object}
                        • subGenres (array) - List of Tertiary Genre linked to the Secondary Genre
                          • {array item object}
                            • id (string) - The ID of the classification's level
                            • name (string) - The Name of the classification's level
                            • locale (string) - Locale in which the content is returned
                        • id (string) - The ID of the classification's level
                        • name (string) - The Name of the classification's level
                        • locale (string) - Locale in which the content is returned
                    • id (string) - The ID of the classification's level
                    • name (string) - The Name of the classification's level
                    • locale (string) - Locale in which the content is returned
                  • genre (object) - Secondary Genre to further describe an entity (Rock, Classical, Animation, etc)
                    • id (string) - The ID of the classification's level
                    • name (string) - The Name of the classification's level
                    • locale (string) - Locale in which the content is returned
                  • subGenre (object) - Tertiary Genre for additional detail when describring an entity (Alternative Rock, Ambient Pop, etc)
                    • id (string) - The ID of the classification's level
                    • name (string) - The Name of the classification's level
                    • locale (string) - Locale in which the content is returned
                  • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
                    • subTypes (array) - List of Sub Types linked to the Type
                      • {array item object}
                        • id (string) - The ID of the classification's level
                        • name (string) - The Name of the classification's level
                        • locale (string) - Locale in which the content is returned
                    • id (string) - The ID of the classification's level
                    • name (string) - The Name of the classification's level
                    • locale (string) - Locale in which the content is returned
                  • subType (object) - Secondary Type to further categorize an entity (Band, Choir, Chorus, etc)
                    • id (string) - The ID of the classification's level
                    • name (string) - The Name of the classification's level
                    • locale (string) - Locale in which the content is returned
                  • family (boolean) - True if this is a family classification
              • externalLinks (object) - List of external links
              • test (boolean) - Indicate if this is a test entity, by default test entities won't appear in discovery API
              • aliases (array) - List of aliases for entity
                • [ "string" ] - No description specified
              • localizedAliases (object) - List of localized aliases for entity
              • upcomingEvents (object) - number of upcoming events
        • type(string) - Type of the entity
        • distance(number)double
        • units(string)No description specified
        • location(object)No description specified
          • longitude (number) - Longitude
          • latitude (number) - Latitude
        • id(string) - Unique id of the entity in the discovery API
        • locale(string) - Locale in which the content is returned
        • name(string) - Name of the entity
        • description(string) - Description's of the entity
        • additionalInfo(string) - Additional information of the entity
        • url(string) - URL of a web site detail page of the entity
        • images(array) - Images of the entity
          • { array item object }
            • url (string) - Public URL of the image
            • ratio (string) - Aspect ratio of the image
            • width (integer) - Width of the image
            • height (integer) - Height of the image
            • fallback (boolean) - true if the image is not the event's image but a fallbak image
            • attribution (string) - Attribution of the image
        • dates(object) - Event's dates information
          • start (object) - Event's start dates. The date and time when the event will start
            • localDate (string) - The event start date in local date
            • localTime (object) - The event end time in local time
              • chronology (object)
                • zone (object)
                  • fixed (boolean)
                  • id (string)
              • millisOfSecond (integer) - int32
              • millisOfDay (integer) - int32
              • secondOfMinute (integer) - int32
              • minuteOfHour (integer) - int32
              • hourOfDay (integer) - int32
              • values (array)
                • {array item object}
                  • type (integer)
                  • format (int32)
              • fieldTypes (array)
                • {array item object}
                  • durationType (object)
                    • name (string)
                  • rangeDurationType (object)
                    • name (string)
                  • name (string)
              • fields (array)
                • {array item object}
                  • lenient (boolean)
                  • minimumValue (integer) - int32
                  • leapDurationField (object)
                    • unitMillis (integer) - int64
                    • precise (boolean)
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • maximumValue (integer) - int32
                  • durationField (object)
                    • unitMillis (integer) - int64
                    • precise (boolean)
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • rangeDurationField (object)
                    • unitMillis (integer) - int64
                    • precise (boolean)
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • name (string)
                  • type (object)
                    • durationType (object)
                      • name (string)
                    • rangeDurationType (object)
                      • name (string)
                    • name (string)
                  • supported (boolean)
            • dateTime (string) - The event start datetime
            • dateTBD (boolean) - Boolean flag to indicate whether or not the start date is TBD
            • dateTBA (boolean) - Boolean flag to indicate whether or not the start date is TBA
            • timeTBA (boolean) - Boolean flag to indicate whether or not the start time is TBA
            • noSpecificTime (boolean) - Boolean flag to indicate whether or not the event start time has no specific time
          • end (object) - Event's end dates. The date and time when the event will end
            • localDate (string) - The event end date in local date
            • localTime (object) - The event end time in local time
              • chronology (object)
                • zone (object)
                  • fixed (boolean)
                  • id (string)
              • millisOfSecond (integer) - int32
              • millisOfDay (integer) - int32
              • secondOfMinute (integer) - int32
              • minuteOfHour (integer) - int32
              • hourOfDay (integer) - int32
              • values (array)
                • {array item object}
                  • type (integer)
                  • format (int32)
              • fieldTypes (array)
                • {array item object}
                  • durationType (object)
                    • name (string)
                  • rangeDurationType (object)
                    • name (string)
                  • name (string)
              • fields (array)
                • {array item object}
                  • lenient (boolean)
                  • minimumValue (integer) - int32
                  • leapDurationField (object)
                    • unitMillis (integer) - int64
                    • precise (boolean)
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • maximumValue (integer) - int32
                  • durationField (object)
                    • unitMillis (integer) - int64
                    • precise (boolean)
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • rangeDurationField (object)
                    • unitMillis (integer) - int64
                    • precise (boolean)
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • name (string)
                  • type (object)
                    • durationType (object)
                      • name (string)
                    • rangeDurationType (object)
                      • name (string)
                    • name (string)
                  • supported (boolean)
            • dateTime (string) - The event end date time
            • approximate (boolean) - Boolean flag to indicate whether or not the end date is approximated
            • noSpecificTime (boolean) - Boolean flag to indicate whether or not the event end time has no specific time
          • access (object) - Event's access dates. The date and time the fan can access the event
            • startDateTime (string) - Event's start access time
            • startApproximate (boolean) - Boolean flag to indicate whether or not the access start date is approximated
            • endDateTime (string) - Event's end access time
            • endApproximate (boolean) - Boolean flag to indicate whether or not the access end date is approximated
          • timezone (string) - Event's timezone
          • status (object) - Status of the event
            • code (string) - The event's status code
          • spanMultipleDays (boolean) - Flag indicating if date spans of multiple days
        • sales(object) - Event's sales dates information
          • public (object) - Public onsale information on this event
            • startDateTime (string) - Public sale's start dates. The date and time when the public sale will start
            • endDateTime (string) - Public sale's end dates. The date and time when the public sale will end
            • startTBD (boolean) - True if the public sale's date is to be determined
          • presales (array) - Presale information on this event
            • {array item object}
              • name (string) - Name of the presale
              • description (string) - Description of the presame
              • url (string) - Presale link URL
              • startDateTime (string) - Presale's start dates. The date and time when the presale will start
              • endDateTime (string) - Presale's end dates. The date and time when the presale will end
        • info(string) - Any information related to the event
        • pleaseNote(string) - Any notes related to the event
        • priceRanges(array) - Price ranges of this event
          • { array item object }
            • type (string) - Type of price
            • currency (string) - Currency
            • min (number) - Minimum price
            • max (number) - Maximum price
        • promoter(object) - Event's promoter
          • id (string) - Id of the promoter
          • name (string) - Name of the promoter
          • description (string) - Description of the promoter
        • promoters(array) - Event's promoters
          • { array item object }
            • id (string) - Id of the promoter
            • name (string) - Name of the promoter
            • description (string) - Description of the promoter
        • outlets(array) - Related outlets informations
          • { array item object }
            • url (string) - Outlet's url
            • type (string) - Outlet's type
        • products(array) - Related products informations
          • { array item object }
            • name (string) - Name of the entity
            • id (string) - Product's primary id
            • url (string) - Product's url
            • type (string) - Product's type
        • seatmap(object) - Event's seatmap
          • staticUrl (string) - Static Seatmap Url
        • accessibility(object) - Additional information for people who experience disabilities
          • info (string) - Accessibility's information
        • ticketLimit(object) - ticket limit
          • infos (object) - ticket limits text - multi-lingual fields
          • info (string) - ticket limits text
        • classifications(array) - Event's classifications
          • { array item object }
            • primary (boolean) - True if this is the entity's primary classification
            • segment (object) - A Segment is a primary genre for an entity (Music, Sports, Arts, etc)
              • genres (array) - List of Genre linked to the Segment
                • {array item object}
                  • subGenres (array) - List of Tertiary Genre linked to the Secondary Genre
                    • {array item object}
                      • id (string) - The ID of the classification's level
                      • name (string) - The Name of the classification's level
                      • locale (string) - Locale in which the content is returned
                  • id (string) - The ID of the classification's level
                  • name (string) - The Name of the classification's level
                  • locale (string) - Locale in which the content is returned
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • genre (object) - Secondary Genre to further describe an entity (Rock, Classical, Animation, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • subGenre (object) - Tertiary Genre for additional detail when describring an entity (Alternative Rock, Ambient Pop, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
              • subTypes (array) - List of Sub Types linked to the Type
                • {array item object}
                  • id (string) - The ID of the classification's level
                  • name (string) - The Name of the classification's level
                  • locale (string) - Locale in which the content is returned
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • subType (object) - Secondary Type to further categorize an entity (Band, Choir, Chorus, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • family (boolean) - True if this is a family classification
        • place(object) - Place has the information on where the event happens. It can be set if there is no venue
          • area (object) - Area of the place
            • name (string) - Name of the entity
          • address (object) - Address of the place
            • line1 (string) - Address first line
            • line2 (string) - Address second line
            • line3 (string) - Address third line
          • city (object) - City of the Place
            • name (string) - Name of the entity
          • state (object) - State / Province of the place
            • stateCode (string) - State code
            • name (string) - Name of the entity
          • country (object) - Country of the place
            • countryCode (string) - Country code (ISO 3166)
            • name (string) - Name of the entity
          • postalCode (string) - Postal code / zipcode of the place
          • location (object) - Location of the place
            • longitude (number) - Longitude
            • latitude (number) - Latitude
          • name (string) - Name of the entity
        • externalLinks(object) - List of external links
        • test(boolean) - Indicate if this is a test entity, by default test entities won't appear in discovery API
        • aliases(array) - List of aliases for entity
          • [ "string" ]
        • localizedAliases(object) - List of localized aliases for entity
  • page(object) - information about current page in data source
    • size(number) - size of page.
    • totalElements(number) - total number of available elements in server
    • totalPages(number) - total number of available pages in server
    • number(number) - current page number counted from 0

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/events.json?size=1&apikey={apikey}",
  async:true,
  dataType: "json",
  success: function(json) {
              console.log(json);
              // Parse the response.
              // Do other things.
           },
  error: function(xhr, status, err) {
              // This time, we do not end up here!
           }
});
curl \
--include 'https://app.ticketmaster.com/discovery/v2/events.json?size=1&apikey={apikey}'

Examples:

Request Response

GET /discovery/v2/events.json?apikey={apikey}&size=1 HTTP/1.1
Host: app.ticketmaster.com
X-Target-URI: https://app.ticketmaster.com
Connection: Keep-Alive
HTTP/1.1 200 OK
Rate-Limit-Over: 0
Content-Length: 5360
Rate-Limit-Available: 4723
Set-Cookie: CMPS=0ytJbt229sTM7UXhHxC5IEvVNguFRwkBBUZ76aK9bmvRvAWZwe/RjM5TSH0yOXNFGd+urQFTC6o=; path=/
Access-Control-Max-Age: 3628800
Access-Control-Allow-Methods: GET, PUT, POST, DELETE
Connection: keep-alive
Server: Apache-Coyote/1.1
Rate-Limit-Reset: 1457417554290
Access-Control-Allow-Headers: origin, x-requested-with, accept
Date: Mon, 07 Mar 2016 10:09:51 GMT
Access-Control-Allow-Origin: *
X-Application-Context: application:local,default,jphx1:8080
Content-Type: application/json;charset=utf-8
X-Unknown-Params: apikey
X-Unknown-Params: api-key
Rate-Limit: 5000

{
  "_links":  {
    "self":  {
      "href": "/discovery/v2/events.json?size=1{&page,sort}",
      "templated": true
    },
    "next":  {
      "href": "/discovery/v2/events.json?page=1&size=1{&sort}",
      "templated": true
    }
  },
  "_embedded":  {
    "events":  [
       {
        "name": "WGC Cadillac Championship - Sunday Ticket",
        "type": "event",
        "id": "vvG1VZKS5pr1qy",
        "test": false,
        "url": "http://ticketmaster.com/event/0E0050681F51BA4C",
        "locale": "en-us",
        "images":  [
           {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_RETINA_LANDSCAPE_16_9.jpg",
            "width": 1136,
            "height": 639,
            "fallback": false
          },
           {
            "ratio": "3_2",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_RETINA_PORTRAIT_3_2.jpg",
            "width": 640,
            "height": 427,
            "fallback": false
          },
           {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_TABLET_LANDSCAPE_LARGE_16_9.jpg",
            "width": 2048,
            "height": 1152,
            "fallback": false
          },
           {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_TABLET_LANDSCAPE_16_9.jpg",
            "width": 1024,
            "height": 576,
            "fallback": false
          },
           {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_EVENT_DETAIL_PAGE_16_9.jpg",
            "width": 205,
            "height": 115,
            "fallback": false
          },
           {
            "ratio": "3_2",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_ARTIST_PAGE_3_2.jpg",
            "width": 305,
            "height": 203,
            "fallback": false
          },
           {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_RETINA_PORTRAIT_16_9.jpg",
            "width": 640,
            "height": 360,
            "fallback": false
          },
           {
            "ratio": "4_3",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_CUSTOM.jpg",
            "width": 305,
            "height": 225,
            "fallback": false
          },
           {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_RECOMENDATION_16_9.jpg",
            "width": 100,
            "height": 56,
            "fallback": false
          },
           {
            "ratio": "3_2",
            "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_TABLET_LANDSCAPE_3_2.jpg",
            "width": 1024,
            "height": 683,
            "fallback": false
          }
        ],
        "sales":  {
          "public":  {
            "startDateTime": "2015-10-02T11:00:00Z",
            "startTBD": false,
            "endDateTime": "2016-03-06T23:00:00Z"
          }
        },
        "dates":  {
          "start":  {
            "localDate": "2016-03-06",
            "dateTBD": false,
            "dateTBA": false,
            "timeTBA": true,
            "noSpecificTime": false
          },
          "timezone": "America/New_York",
          "status":  {
            "code": "offsale"
          }
        },
        "classifications":  [
           {
            "primary": true,
            "segment":  {
              "id": "KZFzniwnSyZfZ7v7nE",
              "name": "Sports"
            },
            "genre":  {
              "id": "KnvZfZ7vAdt",
              "name": "Golf"
            },
            "subGenre":  {
              "id": "KZazBEonSMnZfZ7vFI7",
              "name": "PGA Tour"
            }
          }
        ],
        "promoter":  {
          "id": "682"
        },
        "_links":  {
          "self":  {
            "href": "/discovery/v2/events/vvG1VZKS5pr1qy?locale=en-us"
          },
          "attractions":  [
             {
              "href": "/discovery/v2/attractions/K8vZ917uc57?locale=en-us"
            }
          ],
          "venues":  [
             {
              "href": "/discovery/v2/venues/KovZpZAaEldA?locale=en-us"
            }
          ]
        },
        "_embedded":  {
          "venues":  [
             {
              "name": "Trump National Doral",
              "type": "venue",
              "id": "KovZpZAaEldA",
              "test": false,
              "locale": "en-us",
              "postalCode": "33178",
              "timezone": "America/New_York",
              "city":  {
                "name": "Miami"
              },
              "state":  {
                "name": "Florida",
                "stateCode": "FL"
              },
              "country":  {
                "name": "United States Of America",
                "countryCode": "US"
              },
              "address":  {
                "line1": "4400 NW 87th Avenue"
              },
              "location":  {
                "longitude": "-80.33854298",
                "latitude": "25.81260379"
              },
              "markets":  [
                 {
                  "id": "15"
                }
              ],
              "_links":  {
                "self":  {
                  "href": "/discovery/v2/venues/KovZpZAaEldA?locale=en-us"
                }
              }
            }
          ],
          "attractions":  [
             {
              "name": "Cadillac Championship",
              "type": "attraction",
              "id": "K8vZ917uc57",
              "test": false,
              "locale": "en-us",
              "images":  [
                 {
                  "ratio": "16_9",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_RETINA_LANDSCAPE_16_9.jpg",
                  "width": 1136,
                  "height": 639,
                  "fallback": false
                },
                 {
                  "ratio": "3_2",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_RETINA_PORTRAIT_3_2.jpg",
                  "width": 640,
                  "height": 427,
                  "fallback": false
                },
                 {
                  "ratio": "16_9",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_TABLET_LANDSCAPE_LARGE_16_9.jpg",
                  "width": 2048,
                  "height": 1152,
                  "fallback": false
                },
                 {
                  "ratio": "16_9",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_TABLET_LANDSCAPE_16_9.jpg",
                  "width": 1024,
                  "height": 576,
                  "fallback": false
                },
                 {
                  "ratio": "16_9",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_EVENT_DETAIL_PAGE_16_9.jpg",
                  "width": 205,
                  "height": 115,
                  "fallback": false
                },
                 {
                  "ratio": "3_2",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_ARTIST_PAGE_3_2.jpg",
                  "width": 305,
                  "height": 203,
                  "fallback": false
                },
                 {
                  "ratio": "16_9",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_RETINA_PORTRAIT_16_9.jpg",
                  "width": 640,
                  "height": 360,
                  "fallback": false
                },
                 {
                  "ratio": "4_3",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_CUSTOM.jpg",
                  "width": 305,
                  "height": 225,
                  "fallback": false
                },
                 {
                  "ratio": "16_9",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_RECOMENDATION_16_9.jpg",
                  "width": 100,
                  "height": 56,
                  "fallback": false
                },
                 {
                  "ratio": "3_2",
                  "url": "http://s1.ticketm.net/dam/a/196/6095e742-64d1-4b15-aeac-c9733c52d196_66341_TABLET_LANDSCAPE_3_2.jpg",
                  "width": 1024,
                  "height": 683,
                  "fallback": false
                }
              ],
              "classifications":  [
                 {
                  "primary": true,
                  "segment":  {
                    "id": "KZFzniwnSyZfZ7v7nE",
                    "name": "Sports"
                  },
                  "genre":  {
                    "id": "KnvZfZ7vAdt",
                    "name": "Golf"
                  },
                  "subGenre":  {
                    "id": "KZazBEonSMnZfZ7vFI7",
                    "name": "PGA Tour"
                  }
                }
              ],
              "_links":  {
                "self":  {
                  "href": "/discovery/v2/attractions/K8vZ917uc57?locale=en-us"
                }
              }
            }
          ]
        }
      }
    ]
  },
  "page":  {
    "size": 1,
    "totalElements": 87958,
    "totalPages": 87958,
    "number": 0
  }
}

Get Event Details

Method: GET

Summary: Get Event Details

Description: Get details for a specific event using the unique identifier for the event. This includes the venue and location, the attraction(s), and the Ticketmaster Website URL for purchasing tickets for the event.

/discovery/v2/events/{id}

URL parameters:

Parameter Description Type Default Value Required
id ID of the event String Yes

Query parameters:

Parameter Description Type Default Value Required
locale 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,*') String en No
domain Filter entities based on domains they are available on Array No

Response structure:

200 successful operation

  • _links(object) - links to data sets
    • self(object) - link to this data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
    • venues(array) - link to this data set.
      • {array item object}
        • href(string) - reference
        • templated(boolean) - ability to be templated
    • attractions(array) - link to this data set.
      • {array item object}
        • href(string) - reference
        • templated(boolean) - ability to be templated
  • _embedded(object) - container
    • venues(array) - related
      • {array item object}
        • _links(object) - links to data sets
          • self(object) - link to this data set
            • href(string) - reference
            • templated(boolean) - ability to be templated
          • venues(array) - link to this data set.
            • {array item object}
              • href(string) - reference
              • templated(boolean) - ability to be templated
          • attractions(array) - link to this data set.
            • {array item object}
              • href(string) - reference
              • templated(boolean) - ability to be templated
        • _links(object) - links to data sets
          • self(object) - link to this data set
            • href(string) - reference
            • templated(boolean) - ability to be templated
        • type (string) - Type of the entity
        • distance (number) - double
        • units (string)
        • id (string) - Unique id of the entity in the discovery API
        • locale (string) - Locale in which the content is returned
        • name (string) - Name of the entity
        • description (string) - Description's of the entity
        • address (object) - Address of the venue
          • line1 (string) - Address first line
          • line2 (string) - Address second line
          • line3 (string) - Address third line
        • city (object) - City of the venue
          • name (string) - Name of the entity
        • additionalInfo (string) - Additional information of the entity
        • state (object) - State / Province of the venue
          • stateCode (string) - State code
          • name (string) - Name of the entity
        • country (object) - Country of the venue
          • countryCode (string) - Country code (ISO 3166)
          • name (string) - Name of the entity
        • url (string) - URL of a web site detail page of the entity
        • postalCode (string) - Postal code / zipcode of the venue
        • location (object) - Location of the venue
          • longitude (number) - Longitude
          • latitude (number) - Latitude
        • timezone (string) - Timezone of the venue
        • currency (string) - Default currency of ticket prices for events in this venue
        • markets (array) - Markets of the venue
          • {array item object}
            • id (string) - Market's id
        • images (array) - Images of the entity
          • {array item object}
            • url (string) - Public URL of the image
            • ratio (string) - Aspect ratio of the image
            • width (integer) - Width of the image
            • height (integer) - Height of the image
            • fallback (boolean) - true if the image is not the event's image but a fallbak image
            • attribution (string) - Attribution of the image
        • dma (array) - The list of associated DMAs (Designated Market Areas) of the venue
          • {array item object}
            • id (integer) - DMS's id
        • social (object) - Social networks data
          • twitter (object) - Twitter data
            • handle (string) - Twitter handle
            • hashtags (array) - Twitter hashtags
              • [ "string" ] - No description specified
        • boxOfficeInfo (object) - Box office informations for the venue
          • phoneNumberDetail (string) - Venue box office phone number
          • openHoursDetail (string) - Venue box office opening hours
          • acceptedPaymentDetail (string) - Venue box office accepted payment details
          • willCallDetail (string) - Venue box office will call details
        • parkingDetail (string) - Venue parking info
        • accessibleSeatingDetail (string) - Venue accessible seating detail
        • generalInfo (object) - General informations on the venue
          • generalRule (string) - Venue general rules
          • childRule (string) - Venue children rule
        • externalLinks (object) - List of external links
        • test (boolean) - Indicate if this is a test entity, by default test entities won't appear in discovery API
        • aliases (array) - List of aliases for entity
          • [ "string" ] - No description specified
        • localizedAliases (object) - List of localized aliases for entity
        • upcomingEvents (object) - number of upcoming events
        • ada (object) - ADA information
          • adaPhones (string)
          • adaCustomCopy (string)
          • adaHours (string)
    • attractions(array) - related
      • {array item object}
        • _links(object) - links to data sets
          • self(object) - link to this data set
            • href(string) - reference
            • templated(boolean) - ability to be templated
          • venues(array) - link to this data set.
            • {array item object}
              • href(string) - reference
              • templated(boolean) - ability to be templated
          • attractions(array) - link to this data set.
            • {array item object}
              • href(string) - reference
              • templated(boolean) - ability to be templated
        • _links(object) - links to data sets
          • self(object) - link to this data set
            • href(string) - reference
            • templated(boolean) - ability to be templated
        • type (string) - Type of the entity
        • id (string) - Unique id of the entity in the discovery API
        • locale (string) - Locale in which the content is returned
        • name (string) - Name of the entity
        • description (string) - Description's of the entity
        • additionalInfo (string) - Additional information of the entity
        • url (string) - URL of a web site detail page of the entity
        • images (array) - Images of the entity
          • {array item object}
            • url (string) - Public URL of the image
            • ratio (string) - Aspect ratio of the image
            • width (integer) - Width of the image
            • height (integer) - Height of the image
            • fallback (boolean) - true if the image is not the event's image but a fallbak image
            • attribution (string) - Attribution of the image
        • classifications (array) - Attraction's classifications
          • {array item object}
            • primary (boolean) - True if this is the entity's primary classification
            • segment (object) - A Segment is a primary genre for an entity (Music, Sports, Arts, etc)
              • genres (array) - List of Genre linked to the Segment
                • {array item object}
                  • subGenres (array) - List of Tertiary Genre linked to the Secondary Genre
                    • {array item object}
                      • id (string) - The ID of the classification's level
                      • name (string) - The Name of the classification's level
                      • locale (string) - Locale in which the content is returned
                  • id (string) - The ID of the classification's level
                  • name (string) - The Name of the classification's level
                  • locale (string) - Locale in which the content is returned
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • genre (object) - Secondary Genre to further describe an entity (Rock, Classical, Animation, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • subGenre (object) - Tertiary Genre for additional detail when describring an entity (Alternative Rock, Ambient Pop, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
              • subTypes (array) - List of Sub Types linked to the Type
                • {array item object}
                  • id (string) - The ID of the classification's level
                  • name (string) - The Name of the classification's level
                  • locale (string) - Locale in which the content is returned
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • subType (object) - Secondary Type to further categorize an entity (Band, Choir, Chorus, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • family (boolean) - True if this is a family classification
        • externalLinks (object) - List of external links
        • test (boolean) - Indicate if this is a test entity, by default test entities won't appear in discovery API
        • aliases (array) - List of aliases for entity
          • [ "string" ] - No description specified
        • localizedAliases (object) - List of localized aliases for entity
        • upcomingEvents (object) - number of upcoming events
  • type(string) - Type of the entity
  • distance(number)double
  • units(string)No description specified
  • location(object)No description specified
    • longitude (number) - Longitude
    • latitude (number) - Latitude
  • id(string) - Unique id of the entity in the discovery API
  • locale(string) - Locale in which the content is returned
  • name(string) - Name of the entity
  • description(string) - Description's of the entity
  • additionalInfo(string) - Additional information of the entity
  • url(string) - URL of a web site detail page of the entity
  • images(array) - Images of the entity
    • { array item object }
      • url (string) - Public URL of the image
      • ratio (string) - Aspect ratio of the image
      • width (integer) - Width of the image
      • height (integer) - Height of the image
      • fallback (boolean) - true if the image is not the event's image but a fallbak image
      • attribution (string) - Attribution of the image
  • dates(object) - Event's dates information
    • start (object) - Event's start dates. The date and time when the event will start
      • localDate (string) - The event start date in local date
      • localTime (object) - The event end time in local time
        • chronology (object)
          • zone (object)
            • fixed (boolean)
            • id (string)
        • millisOfSecond (integer) - int32
        • millisOfDay (integer) - int32
        • secondOfMinute (integer) - int32
        • minuteOfHour (integer) - int32
        • hourOfDay (integer) - int32
        • values (array)
          • {array item object}
            • type (integer)
            • format (int32)
        • fieldTypes (array)
          • {array item object}
            • durationType (object)
              • name (string)
            • rangeDurationType (object)
              • name (string)
            • name (string)
        • fields (array)
          • {array item object}
            • lenient (boolean)
            • minimumValue (integer) - int32
            • leapDurationField (object)
              • unitMillis (integer) - int64
              • precise (boolean)
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • maximumValue (integer) - int32
            • durationField (object)
              • unitMillis (integer) - int64
              • precise (boolean)
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • rangeDurationField (object)
              • unitMillis (integer) - int64
              • precise (boolean)
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • name (string)
            • type (object)
              • durationType (object)
                • name (string)
              • rangeDurationType (object)
                • name (string)
              • name (string)
            • supported (boolean)
      • dateTime (string) - The event start datetime
      • dateTBD (boolean) - Boolean flag to indicate whether or not the start date is TBD
      • dateTBA (boolean) - Boolean flag to indicate whether or not the start date is TBA
      • timeTBA (boolean) - Boolean flag to indicate whether or not the start time is TBA
      • noSpecificTime (boolean) - Boolean flag to indicate whether or not the event start time has no specific time
    • end (object) - Event's end dates. The date and time when the event will end
      • localDate (string) - The event end date in local date
      • localTime (object) - The event end time in local time
        • chronology (object)
          • zone (object)
            • fixed (boolean)
            • id (string)
        • millisOfSecond (integer) - int32
        • millisOfDay (integer) - int32
        • secondOfMinute (integer) - int32
        • minuteOfHour (integer) - int32
        • hourOfDay (integer) - int32
        • values (array)
          • {array item object}
            • type (integer)
            • format (int32)
        • fieldTypes (array)
          • {array item object}
            • durationType (object)
              • name (string)
            • rangeDurationType (object)
              • name (string)
            • name (string)
        • fields (array)
          • {array item object}
            • lenient (boolean)
            • minimumValue (integer) - int32
            • leapDurationField (object)
              • unitMillis (integer) - int64
              • precise (boolean)
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • maximumValue (integer) - int32
            • durationField (object)
              • unitMillis (integer) - int64
              • precise (boolean)
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • rangeDurationField (object)
              • unitMillis (integer) - int64
              • precise (boolean)
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • name (string)
            • type (object)
              • durationType (object)
                • name (string)
              • rangeDurationType (object)
                • name (string)
              • name (string)
            • supported (boolean)
      • dateTime (string) - The event end date time
      • approximate (boolean) - Boolean flag to indicate whether or not the end date is approximated
      • noSpecificTime (boolean) - Boolean flag to indicate whether or not the event end time has no specific time
    • access (object) - Event's access dates. The date and time the fan can access the event
      • startDateTime (string) - Event's start access time
      • startApproximate (boolean) - Boolean flag to indicate whether or not the access start date is approximated
      • endDateTime (string) - Event's end access time
      • endApproximate (boolean) - Boolean flag to indicate whether or not the access end date is approximated
    • timezone (string) - Event's timezone
    • status (object) - Status of the event
      • code (string) - The event's status code
    • spanMultipleDays (boolean) - Flag indicating if date spans of multiple days
  • sales(object) - Event's sales dates information
    • public (object) - Public onsale information on this event
      • startDateTime (string) - Public sale's start dates. The date and time when the public sale will start
      • endDateTime (string) - Public sale's end dates. The date and time when the public sale will end
      • startTBD (boolean) - True if the public sale's date is to be determined
    • presales (array) - Presale information on this event
      • {array item object}
        • name (string) - Name of the presale
        • description (string) - Description of the presame
        • url (string) - Presale link URL
        • startDateTime (string) - Presale's start dates. The date and time when the presale will start
        • endDateTime (string) - Presale's end dates. The date and time when the presale will end
  • info(string) - Any information related to the event
  • pleaseNote(string) - Any notes related to the event
  • priceRanges(array) - Price ranges of this event
    • { array item object }
      • type (string) - Type of price
      • currency (string) - Currency
      • min (number) - Minimum price
      • max (number) - Maximum price
  • promoter(object) - Event's promoter
    • id (string) - Id of the promoter
    • name (string) - Name of the promoter
    • description (string) - Description of the promoter
  • promoters(array) - Event's promoters
    • { array item object }
      • id (string) - Id of the promoter
      • name (string) - Name of the promoter
      • description (string) - Description of the promoter
  • outlets(array) - Related outlets informations
    • { array item object }
      • url (string) - Outlet's url
      • type (string) - Outlet's type
  • products(array) - Related products informations
    • { array item object }
      • name (string) - Name of the entity
      • id (string) - Product's primary id
      • url (string) - Product's url
      • type (string) - Product's type
  • seatmap(object) - Event's seatmap
    • staticUrl (string) - Static Seatmap Url
  • accessibility(object) - Additional information for people who experience disabilities
    • info (string) - Accessibility's information
  • ticketLimit(object) - ticket limit
    • infos (object) - ticket limits text - multi-lingual fields
    • info (string) - ticket limits text
  • classifications(array) - Event's classifications
    • { array item object }
      • primary (boolean) - True if this is the entity's primary classification
      • segment (object) - A Segment is a primary genre for an entity (Music, Sports, Arts, etc)
        • genres (array) - List of Genre linked to the Segment
          • {array item object}
            • subGenres (array) - List of Tertiary Genre linked to the Secondary Genre
              • {array item object}
                • id (string) - The ID of the classification's level
                • name (string) - The Name of the classification's level
                • locale (string) - Locale in which the content is returned
            • id (string) - The ID of the classification's level
            • name (string) - The Name of the classification's level
            • locale (string) - Locale in which the content is returned
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • genre (object) - Secondary Genre to further describe an entity (Rock, Classical, Animation, etc)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • subGenre (object) - Tertiary Genre for additional detail when describring an entity (Alternative Rock, Ambient Pop, etc)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
        • subTypes (array) - List of Sub Types linked to the Type
          • {array item object}
            • id (string) - The ID of the classification's level
            • name (string) - The Name of the classification's level
            • locale (string) - Locale in which the content is returned
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • subType (object) - Secondary Type to further categorize an entity (Band, Choir, Chorus, etc)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • family (boolean) - True if this is a family classification
  • place(object) - Place has the information on where the event happens. It can be set if there is no venue
    • area (object) - Area of the place
      • name (string) - Name of the entity
    • address (object) - Address of the place
      • line1 (string) - Address first line
      • line2 (string) - Address second line
      • line3 (string) - Address third line
    • city (object) - City of the Place
      • name (string) - Name of the entity
    • state (object) - State / Province of the place
      • stateCode (string) - State code
      • name (string) - Name of the entity
    • country (object) - Country of the place
      • countryCode (string) - Country code (ISO 3166)
      • name (string) - Name of the entity
    • postalCode (string) - Postal code / zipcode of the place
    • location (object) - Location of the place
      • longitude (number) - Longitude
      • latitude (number) - Latitude
    • name (string) - Name of the entity
  • externalLinks(object) - List of external links
  • test(boolean) - Indicate if this is a test entity, by default test entities won't appear in discovery API
  • aliases(array) - List of aliases for entity
    • [ "string" ]
  • localizedAliases(object) - List of localized aliases for entity

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/events/G5diZfkn0B-bh.json?apikey={apikey}",
  async:true,
  dataType: "json",
  success: function(json) {
              console.log(json);
              // Parse the response.
              // Do other things.
           },
  error: function(xhr, status, err) {
              // This time, we do not end up here!
           }
});
curl \
--include 'https://app.ticketmaster.com/discovery/v2/events/G5diZfkn0B-bh.json?apikey={apikey}'

Examples:

Request Response

GET /discovery/v2/events/G5diZfkn0B-bh.json?apikey={apikey} HTTP/1.1
Host: app.ticketmaster.com
X-Target-URI: https://app.ticketmaster.com
Connection: Keep-Alive
HTTP/1.1 200 OK
Rate-Limit-Over: 0
Content-Length: 5555
Rate-Limit-Available: 4722
Set-Cookie: CMPS=cE7N5yujrQNGYWvJF3bAH6iRNHwAv0FDp5i1VDetaW6+WW5OZTOBve6ZQCpN9qCv; path=/
Access-Control-Max-Age: 3628800
Access-Control-Allow-Methods: GET, PUT, POST, DELETE
Connection: keep-alive
Server: Apache-Coyote/1.1
Rate-Limit-Reset: 1457417554290
Access-Control-Allow-Headers: origin, x-requested-with, accept
Date: Mon, 07 Mar 2016 10:12:45 GMT
Access-Control-Allow-Origin: *
X-Application-Context: application:local,default,jphx1:8080
Content-Type: application/json;charset=utf-8
X-Unknown-Params: apikey
X-Unknown-Params: api-key
Rate-Limit: 5000

{
  "_embedded": {
    "venues": [
      {
        "name": "Madison Square Garden",
        "type": "venue",
        "id": "KovZpZA7AAEA",
        "test": false,
        "url": "http://ticketmaster.com/venue/483329",
        "locale": "en-us",
        "postalCode": "10001",
        "timezone": "America/New_York",
        "city": {
          "name": "New York"
        },
        "state": {
          "name": "New York",
          "stateCode": "NY"
        },
        "country": {
          "name": "United States Of America",
          "countryCode": "US"
        },
        "address": {
          "line1": "7th Ave & 32nd Street"
        },
        "location": {
          "longitude": "-73.99160060",
          "latitude": "40.74970620"
        },
        "markets": [
          {
            "id": "35"
          },
          {
            "id": "51"
          },
          {
            "id": "55"
          },
          {
            "id": "124"
          }
        ],
        "dmas": [
          {
            "id": 200
          },
          {
            "id": 296
          },
          {
            "id": 345
          },
          {
            "id": 422
          }
        ],
        "_links": {
          "self": {
            "href": "/discovery/v2/venues/KovZpZA7AAEA?locale=en-us"
          }
        }
      }
    ],
    "attractions": [
      {
        "name": "Radiohead",
        "type": "attraction",
        "id": "K8vZ91713wV",
        "test": false,
        "url": "http://ticketmaster.com/artist/763468",
        "locale": "en-us",
        "images": [
          {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_EVENT_DETAIL_PAGE_16_9.jpg",
            "width": 205,
            "height": 115,
            "fallback": false
          },
          {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_RETINA_LANDSCAPE_16_9.jpg",
            "width": 1136,
            "height": 639,
            "fallback": false
          },
          {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_RETINA_PORTRAIT_16_9.jpg",
            "width": 640,
            "height": 360,
            "fallback": false
          },
          {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_RECOMENDATION_16_9.jpg",
            "width": 100,
            "height": 56,
            "fallback": false
          },
          {
            "ratio": "3_2",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_RETINA_PORTRAIT_3_2.jpg",
            "width": 640,
            "height": 427,
            "fallback": false
          },
          {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_TABLET_LANDSCAPE_16_9.jpg",
            "width": 1024,
            "height": 576,
            "fallback": false
          },
          {
            "ratio": "3_2",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_ARTIST_PAGE_3_2.jpg",
            "width": 305,
            "height": 203,
            "fallback": false
          },
          {
            "ratio": "16_9",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_TABLET_LANDSCAPE_LARGE_16_9.jpg",
            "width": 2048,
            "height": 1152,
            "fallback": false
          },
          {
            "ratio": "3_2",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_TABLET_LANDSCAPE_3_2.jpg",
            "width": 1024,
            "height": 683,
            "fallback": false
          },
          {
            "ratio": "4_3",
            "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_CUSTOM.jpg",
            "width": 305,
            "height": 225,
            "fallback": false
          }
        ],
        "classifications": [
          {
            "primary": true,
            "segment": {
              "id": "KZFzniwnSyZfZ7v7nJ",
              "name": "Music"
            },
            "genre": {
              "id": "KnvZfZ7vAeA",
              "name": "Rock"
            },
            "subGenre": {
              "id": "KZazBEonSMnZfZ7v6dt",
              "name": "Alternative Rock"
            }
          }
        ],
        "_links": {
          "self": {
            "href": "/discovery/v2/attractions/K8vZ91713wV?locale=en-us"
          }
        }
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/discovery/v2/events/G5diZfkn0B-bh?locale=en-us"
    },
    "attractions": [
      {
        "href": "/discovery/v2/attractions/K8vZ91713wV?locale=en-us"
      }
    ],
    "venues": [
      {
        "href": "/discovery/v2/venues/KovZpZA7AAEA?locale=en-us"
      }
    ]
  },
  "classifications": [
    {
      "primary": true,
      "segment": {
        "id": "KZFzniwnSyZfZ7v7nJ",
        "name": "Music"
      },
      "genre": {
        "id": "KnvZfZ7vAeA",
        "name": "Rock"
      },
      "subGenre": {
        "id": "KZazBEonSMnZfZ7v6dt",
        "name": "Alternative Rock"
      }
    }
  ],
  "dates": {
    "start": {
      "localDate": "2016-07-27",
      "localTime": "19:30:00",
      "dateTime": "2016-07-27T23:30:00Z",
      "dateTBD": false,
      "dateTBA": false,
      "timeTBA": false,
      "noSpecificTime": false
    },
    "timezone": "America/New_York",
    "status": {
      "code": "onsale"
    }
  },
  "id": "G5diZfkn0B-bh",
  "images": [
    {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_EVENT_DETAIL_PAGE_16_9.jpg",
      "width": 205,
      "height": 115,
      "fallback": false
    },
    {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_RETINA_LANDSCAPE_16_9.jpg",
      "width": 1136,
      "height": 639,
      "fallback": false
    },
    {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_RETINA_PORTRAIT_16_9.jpg",
      "width": 640,
      "height": 360,
      "fallback": false
    },
    {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_RECOMENDATION_16_9.jpg",
      "width": 100,
      "height": 56,
      "fallback": false
    },
    {
      "ratio": "3_2",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_RETINA_PORTRAIT_3_2.jpg",
      "width": 640,
      "height": 427,
      "fallback": false
    },
    {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_TABLET_LANDSCAPE_16_9.jpg",
      "width": 1024,
      "height": 576,
      "fallback": false
    },
    {
      "ratio": "3_2",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_ARTIST_PAGE_3_2.jpg",
      "width": 305,
      "height": 203,
      "fallback": false
    },
    {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_TABLET_LANDSCAPE_LARGE_16_9.jpg",
      "width": 2048,
      "height": 1152,
      "fallback": false
    },
    {
      "ratio": "3_2",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_TABLET_LANDSCAPE_3_2.jpg",
      "width": 1024,
      "height": 683,
      "fallback": false
    },
    {
      "ratio": "4_3",
      "url": "http://s1.ticketm.net/dam/a/c4c/e751ab33-b9cd-4d24-ad4a-5ef79faa7c4c_72681_CUSTOM.jpg",
      "width": 305,
      "height": 225,
      "fallback": false
    }
  ],
  "locale": "en-us",
  "name": "Radiohead",
  "pleaseNote": "No tickets will be delivered prior to April 18th. Tickets are not available at the box office on the first day of the public on sale. ARRIVE EARLY: Please arrive one-hour prior to showtime. All packages, including briefcases and pocketbooks, will be inspected prior to entry.",
  "priceRanges": [
    {
      "type": "standard",
      "currency": "USD",
      "min": 80,
      "max": 80
    }
  ],
  "promoter": {
    "id": "494"
  },
  "sales": {
    "public": {
      "startDateTime": "2016-03-18T14:00:00Z",
      "startTBD": false,
      "endDateTime": "2016-07-27T21:30:00Z"
    }
  },
  "test": false,
  "type": "event",
  "url": "http://ticketmaster.com/event/3B00506AA4EA161B"
}

Get Event Images

Method: GET

Summary: Get Event Images

Description: Get images for a specific event using the unique identifier for the event.

/discovery/v2/events/{id}/images

URL parameters:

Parameter Description Type Default Value Required
id ID of the event String Yes

Query parameters:

Parameter Description Type Default Value Required
locale 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,*') String en No
domain Filter entities based on domains they are available on Array No

Response structure:

200 successful operation

  • _links(object) - links to data sets
    • self(object) - link to this data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
  • type(string) - Type of the entity
  • id(string) - Unique id of the entity in the discovery API
  • images(array) - Images of the entity
    • { array item object }
      • url (string) - Public URL of the image
      • ratio (string) - Aspect ratio of the image
      • width (integer) - Width of the image
      • height (integer) - Height of the image
      • fallback (boolean) - true if the image is not the event's image but a fallbak image
      • attribution (string) - Attribution of the image

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/events/k7vGFKzleBdwS/images.json?apikey={apikey}",
  async:true,
  dataType: "json",
  success: function(json) {
              console.log(json);
              // Parse the response.
              // Do other things.
           },
  error: function(xhr, status, err) {
              // This time, we do not end up here!
           }
});
curl \
--include 'https://app.ticketmaster.com/discovery/v2/events/k7vGFKzleBdwS/images.json?apikey={apikey}'

Examples:

Request Response

GET /discovery/v2/events/0B004F0401BD55E5/images.json?apikey={apikey} HTTP/1.1
Host: app.ticketmaster.com
X-Target-URI: https://app.ticketmaster.com
Connection: Keep-Alive
HTTP/1.1 200 OK
Rate-Limit-Over: 0
Content-Length: 1791
Rate-Limit-Available: 4721
Set-Cookie: CMPS=JZE+KB6vdvAgtu5+7+q5LjU8d3RbODYo2jv3r5+vwk0BcMxjtg3kAFdo3D2gFulS; path=/
Access-Control-Max-Age: 3628800
Access-Control-Allow-Methods: GET, PUT, POST, DELETE
Connection: keep-alive
Server: Apache-Coyote/1.1
Rate-Limit-Reset: 1457417554290
Access-Control-Allow-Headers: origin, x-requested-with, accept
Date: Mon, 07 Mar 2016 10:15:18 GMT
Access-Control-Allow-Origin: *
X-Application-Context: application:local,default,jphx1:8080
Content-Type: application/json;charset=utf-8
X-Unknown-Params: apikey
X-Unknown-Params: api-key
Rate-Limit: 5000

{
  "type": "event",
  "id": "k7vGFKzleBdwS",
  "images":  [
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_RECOMENDATION_16_9.jpg",
      "width": 100,
      "height": 56,
      "fallback": false
    },
     {
      "ratio": "3_2",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_ARTIST_PAGE_3_2.jpg",
      "width": 305,
      "height": 203,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_TABLET_LANDSCAPE_LARGE_16_9.jpg",
      "width": 2048,
      "height": 1152,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_RETINA_LANDSCAPE_16_9.jpg",
      "width": 1136,
      "height": 639,
      "fallback": false
    },
     {
      "ratio": "3_2",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_TABLET_LANDSCAPE_3_2.jpg",
      "width": 1024,
      "height": 683,
      "fallback": false
    },
     {
      "ratio": "4_3",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_CUSTOM.jpg",
      "width": 305,
      "height": 225,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_EVENT_DETAIL_PAGE_16_9.jpg",
      "width": 205,
      "height": 115,
      "fallback": false
    },
     {
      "ratio": "3_2",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_RETINA_PORTRAIT_3_2.jpg",
      "width": 640,
      "height": 427,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_RETINA_PORTRAIT_16_9.jpg",
      "width": 640,
      "height": 360,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/063/1689bfea-ae98-4c7e-a31d-bbca2dd14063_54361_TABLET_LANDSCAPE_16_9.jpg",
      "width": 1024,
      "height": 576,
      "fallback": false
    }
  ],
  "_links":  {
    "self":  {
      "href": "/discovery/v2/events/k7vGFKzleBdwS/images?locale=en-us"
    }
  }
}

Attraction Search

Method: GET

Summary: Attraction Search

Description: Find attractions (artists, sports, packages, plays and so on) and filter your search by name, and much more.

/discovery/v2/attractions

Query parameters:

Parameter Description Type Default Value Required
id Filter entities by its id String No
keyword Keyword to search on String No
source Filter entities by its primary source name OR publishing source name String enum:["ticketmaster", " universe", " frontgate", " tmr"] No
locale 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,*') String en No
includeTest True if you want to have entities flag as test in the response. Only, if you only wanted test entities String enum:["yes", " no", " only"] no No
size Page size of the response String 20 No
page Page number String 0 No
sort Sorting order of the search result. Allowable Values : 'name,asc', 'name,desc', 'relevance,asc', 'relevance,desc' String relevance,desc No
classificationName Filter attractions by classification name: name of any segment, genre, sub-genre, type, sub-type Array No
classificationId Filter attractions by classification id: id of any segment, genre, sub-genre, type, sub-type Array No
includeFamily Filter by classification that are family-friendly String enum:["yes", " no", " only"] yes No
segmentId Filter attractions by segmentId Array No
genreId Filter attractions by genreId Array No
subGenreId Filter attractions by subGenreId Array No
typeId Filter attractions by typeId Array No
subTypeId Filter attractions by subTypeId Array No
preferredCountry Popularity boost by country, default is us. String enum:["us", " ca"] us No
includeSpellcheck yes, to include spell check suggestions in the response. String enum:["yes", " no"] no No
domain Filter entities based on domains they are available on Array No

Response structure:

200 successful operation

  • _links(object) - links to data sets
    • self(object) - link to this data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
    • next(object) - link to the next data set
      • href(string) - reference.
      • templated(boolean) - ability to be templated
    • prev(object) - link to the previous data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
  • _embedded(object) - container
    • attractions(array)
      • {array item object}
        • _links(object) - links to data sets
          • self(object) - link to this data set
            • href(string) - reference
            • templated(boolean) - ability to be templated
        • type(string) - Type of the entity
        • id(string) - Unique id of the entity in the discovery API
        • locale(string) - Locale in which the content is returned
        • name(string) - Name of the entity
        • description(string) - Description's of the entity
        • additionalInfo(string) - Additional information of the entity
        • url(string) - URL of a web site detail page of the entity
        • images(array) - Images of the entity
          • { array item object }
            • url (string) - Public URL of the image
            • ratio (string) - Aspect ratio of the image
            • width (integer) - Width of the image
            • height (integer) - Height of the image
            • fallback (boolean) - true if the image is not the event's image but a fallbak image
            • attribution (string) - Attribution of the image
        • classifications(array) - Attraction's classifications
          • { array item object }
            • primary (boolean) - True if this is the entity's primary classification
            • segment (object) - A Segment is a primary genre for an entity (Music, Sports, Arts, etc)
              • genres (array) - List of Genre linked to the Segment
                • {array item object}
                  • subGenres (array) - List of Tertiary Genre linked to the Secondary Genre
                    • {array item object}
                      • id (string) - The ID of the classification's level
                      • name (string) - The Name of the classification's level
                      • locale (string) - Locale in which the content is returned
                  • id (string) - The ID of the classification's level
                  • name (string) - The Name of the classification's level
                  • locale (string) - Locale in which the content is returned
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • genre (object) - Secondary Genre to further describe an entity (Rock, Classical, Animation, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • subGenre (object) - Tertiary Genre for additional detail when describring an entity (Alternative Rock, Ambient Pop, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
              • subTypes (array) - List of Sub Types linked to the Type
                • {array item object}
                  • id (string) - The ID of the classification's level
                  • name (string) - The Name of the classification's level
                  • locale (string) - Locale in which the content is returned
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • subType (object) - Secondary Type to further categorize an entity (Band, Choir, Chorus, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • family (boolean) - True if this is a family classification
        • externalLinks(object) - List of external links
        • test(boolean) - Indicate if this is a test entity, by default test entities won't appear in discovery API
        • aliases(array) - List of aliases for entity
          • [ "string" ]
        • localizedAliases(object) - List of localized aliases for entity
        • upcomingEvents(object) - number of upcoming events
  • page(object) - information about current page in data source
    • size(number) - size of page.
    • totalElements(number) - total number of available elements in server
    • totalPages(number) - total number of available pages in server
    • number(number) - current page number counted from 0

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/attractions.json?apikey={apikey}",
  async:true,
  dataType: "json",
  success: function(json) {
              console.log(json);
              // Parse the response.
              // Do other things.
           },
  error: function(xhr, status, err) {
              // This time, we do not end up here!
           }
});
curl \
--include 'https://app.ticketmaster.com/discovery/v2/attractions.json?apikey={apikey}'

Examples:

Request Response

GET /discovery/v2/attractions.json?size=1&apikey={apikey} HTTP/1.1
Host: app.ticketmaster.com
X-Target-URI: https://app.ticketmaster.com
Connection: Keep-Alive
HTTP/1.1 200 OK
Rate-Limit-Over: 0
Content-Length: 2306
Rate-Limit-Available: 4719
Set-Cookie: CMPS=twsJFiJCd9puX3QeIpWdz1Co+AFBb0GGb2S5IpJoKGFAy6VVeUUgAfUsgfrWYV89; path=/
Access-Control-Max-Age: 3628800
Access-Control-Allow-Methods: GET, PUT, POST, DELETE
Connection: keep-alive
Server: Apache-Coyote/1.1
Rate-Limit-Reset: 1457417554290
Access-Control-Allow-Headers: origin, x-requested-with, accept
Date: Mon, 07 Mar 2016 10:17:30 GMT
Access-Control-Allow-Origin: *
X-Application-Context: application:local,default,jphx1:8080
Content-Type: application/json;charset=utf-8
X-Unknown-Params: apikey
X-Unknown-Params: api-key
Rate-Limit: 5000

{
  "_links":  {},
  "_embedded":  {
    "attractions":  [
       {
        "name": "!!!",
        "type": "attraction",
        "id": "K8vZ9175BhV",
        "test": false,
        "locale": "en-us",
        "images":  [],
        "classifications":  [
           {
            "primary": true,
            "segment":  {
              "id": "KZFzniwnSyZfZ7v7nJ",
              "name": "Music"
            },
            "genre":  {
              "id": "KnvZfZ7vAeA",
              "name": "Rock"
            },
            "subGenre":  {
              "id": "KZazBEonSMnZfZ7v6F1",
              "name": "Pop"
            }
          }
        ],
        "_links":  {
          "self":  {
            "href": "/discovery/v2/attractions/K8vZ9175BhV?locale=en-us"
          }
        }
      }
    ]
  },
  "page":  {
    "size": 1,
    "totalElements": 162165,
    "totalPages": 162165,
    "number": 0
  }
}

Get Attraction Details

Method: GET

Summary: Get Attraction Details

Description: Get details for a specific attraction using the unique identifier for the attraction.

/discovery/v2/attractions/{id}

URL parameters:

Parameter Description Type Default Value Required
id ID of the attraction String Yes

Query parameters:

Parameter Description Type Default Value Required
locale 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,*') String en No
domain Filter entities based on domains they are available on Array No

Response structure:

200 successful operation

  • _links(object) - links to data sets
    • self(object) - link to this data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
  • type(string) - Type of the entity
  • id(string) - Unique id of the entity in the discovery API
  • locale(string) - Locale in which the content is returned
  • name(string) - Name of the entity
  • description(string) - Description's of the entity
  • additionalInfo(string) - Additional information of the entity
  • url(string) - URL of a web site detail page of the entity
  • images(array) - Images of the entity
    • { array item object }
      • url (string) - Public URL of the image
      • ratio (string) - Aspect ratio of the image
      • width (integer) - Width of the image
      • height (integer) - Height of the image
      • fallback (boolean) - true if the image is not the event's image but a fallbak image
      • attribution (string) - Attribution of the image
  • classifications(array) - Attraction's classifications
    • { array item object }
      • primary (boolean) - True if this is the entity's primary classification
      • segment (object) - A Segment is a primary genre for an entity (Music, Sports, Arts, etc)
        • genres (array) - List of Genre linked to the Segment
          • {array item object}
            • subGenres (array) - List of Tertiary Genre linked to the Secondary Genre
              • {array item object}
                • id (string) - The ID of the classification's level
                • name (string) - The Name of the classification's level
                • locale (string) - Locale in which the content is returned
            • id (string) - The ID of the classification's level
            • name (string) - The Name of the classification's level
            • locale (string) - Locale in which the content is returned
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • genre (object) - Secondary Genre to further describe an entity (Rock, Classical, Animation, etc)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • subGenre (object) - Tertiary Genre for additional detail when describring an entity (Alternative Rock, Ambient Pop, etc)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
        • subTypes (array) - List of Sub Types linked to the Type
          • {array item object}
            • id (string) - The ID of the classification's level
            • name (string) - The Name of the classification's level
            • locale (string) - Locale in which the content is returned
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • subType (object) - Secondary Type to further categorize an entity (Band, Choir, Chorus, etc)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • family (boolean) - True if this is a family classification
  • externalLinks(object) - List of external links
  • test(boolean) - Indicate if this is a test entity, by default test entities won't appear in discovery API
  • aliases(array) - List of aliases for entity
    • [ "string" ]
  • localizedAliases(object) - List of localized aliases for entity
  • upcomingEvents(object) - number of upcoming events

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/attractions/K8vZ9175BhV.json?apikey={apikey}",
  async:true,
  dataType: "json",
  success: function(json) {
              console.log(json);
              // Parse the response.
              // Do other things.
           },
  error: function(xhr, status, err) {
              // This time, we do not end up here!
           }
});
curl \
--include 'https://app.ticketmaster.com/discovery/v2/attractions/K8vZ9175BhV.json?apikey={apikey}'

Examples:

Request Response

GET /discovery/v2/attractions/K8vZ9175BhV.json?apikey={apikey} HTTP/1.1
Host: app.ticketmaster.com
X-Target-URI: https://app.ticketmaster.com
Connection: Keep-Alive
HTTP/1.1 200 OK
Rate-Limit-Over: 0
Content-Length: 2019
Rate-Limit-Available: 4715
Set-Cookie: CMPS=5vv+AGPecM7pv5Q4MmLBniGH0DBXyfh68w9nYydgerFjBhsCrQs1DbTINMWnUgrDL0UGMYDHSDc=; path=/
Access-Control-Max-Age: 3628800
Access-Control-Allow-Methods: GET, PUT, POST, DELETE
Connection: keep-alive
Server: Apache-Coyote/1.1
Rate-Limit-Reset: 1457417554290
Access-Control-Allow-Headers: origin, x-requested-with, accept
Date: Mon, 07 Mar 2016 10:21:02 GMT
Access-Control-Allow-Origin: *
X-Application-Context: application:local,default,jash1:8080
Content-Type: application/json;charset=utf-8
X-Unknown-Params: apikey
X-Unknown-Params: api-key
Rate-Limit: 5000

{
  "name": "!!!",
  "type": "attraction",
  "id": "K8vZ9175BhV",
  "test": false,
  "locale": "en-us",
  "images":  [
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_RECOMENDATION_16_9.jpg",
      "width": 100,
      "height": 56,
      "fallback": false
    },
     {
      "ratio": "4_3",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_CUSTOM.jpg",
      "width": 305,
      "height": 225,
      "fallback": false
    },
     {
      "ratio": "3_2",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_ARTIST_PAGE_3_2.jpg",
      "width": 305,
      "height": 203,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_RETINA_PORTRAIT_16_9.jpg",
      "width": 640,
      "height": 360,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_TABLET_LANDSCAPE_LARGE_16_9.jpg",
      "width": 2048,
      "height": 1152,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_TABLET_LANDSCAPE_16_9.jpg",
      "width": 1024,
      "height": 576,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_RETINA_LANDSCAPE_16_9.jpg",
      "width": 1136,
      "height": 639,
      "fallback": false
    },
     {
      "ratio": "3_2",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_RETINA_PORTRAIT_3_2.jpg",
      "width": 640,
      "height": 427,
      "fallback": false
    },
     {
      "ratio": "16_9",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_EVENT_DETAIL_PAGE_16_9.jpg",
      "width": 205,
      "height": 115,
      "fallback": false
    },
     {
      "ratio": "3_2",
      "url": "http://s1.ticketm.net/dam/a/418/aa73b994-9912-4535-ba21-4865ae93a418_41291_TABLET_LANDSCAPE_3_2.jpg",
      "width": 1024,
      "height": 683,
      "fallback": false
    }
  ],
  "classifications":  [
     {
      "primary": true,
      "segment":  {
        "id": "KZFzniwnSyZfZ7v7nJ",
        "name": "Music"
      },
      "genre":  {
        "id": "KnvZfZ7vAeA",
        "name": "Rock"
      },
      "subGenre":  {
        "id": "KZazBEonSMnZfZ7v6F1",
        "name": "Pop"
      }
    }
  ],
  "_links":  {
    "self":  {
      "href": "/discovery/v2/attractions/K8vZ9175BhV?locale=en-us"
    }
  }
}

Classification Search

Method: GET

Summary: Classification Search

Description: Find classifications and filter your search by name, and much more. Classifications help define the nature of attractions and events.

/discovery/v2/classifications

Query parameters:

Parameter Description Type Default Value Required
id Filter entities by its id String No
keyword Keyword to search on String No
source Filter entities by its primary source name OR publishing source name String enum:["ticketmaster", " universe", " frontgate", " tmr"] No
locale 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,*') String en No
includeTest True if you want to have entities flag as test in the response. Only, if you only wanted test entities String enum:["yes", " no", " only"] no No
size Page size of the response String 20 No
page Page number String 0 No
sort Sorting order of the search result String name,asc No
preferredCountry Popularity boost by country, default is us. String enum:["us", " ca"] us No
includeSpellcheck yes, to include spell check suggestions in the response. String enum:["yes", " no"] no No
domain Filter entities based on domains they are available on Array No

Response structure:

200 successful operation

  • _links(object) - links to data sets
    • self(object) - link to this data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
    • next(object) - link to the next data set
      • href(string) - reference.
      • templated(boolean) - ability to be templated
    • prev(object) - link to the previous data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
  • _embedded(object) - container
    • classifications(array)
      • {array item object}
        • _links(object) - links to data sets
          • self(object) - link to this data set
            • href(string) - reference
            • templated(boolean) - ability to be templated
        • segment(object) - A Segment is a primary genre for an entity (Music, Sports, Arts, etc)
          • _embedded(object) - container for genres.
            • genres(object)
              • {array item object}
                • _embedded(object) - container for subgenres.
                  • subgenres(object) - Tertiary Genre for additional detail when describring an entity (Alternative Rock, Ambient Pop, etc)
                    • {array item object}
                      • _links(object) - links to data sets
                        • self(object) - link to this data set
                          • href(string) - reference
                          • templated(boolean) - ability to be templated
                      • id (string) - The ID of the classification's level
                      • name (string) - The Name of the classification's level
                      • locale (string) - Locale in which the content is returned
                • _links(object) - links to data sets
                  • self(object) - link to this data set
                    • href(string) - reference
                    • templated(boolean) - ability to be templated
                • id (string) - The ID of the classification's level
                • name (string) - The Name of the classification's level
                • locale (string) - Locale in which the content is returned
              • _links(object) - links to data sets
                • self(object) - link to this data set
                  • href(string) - reference
                  • templated(boolean) - ability to be templated
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
            • _links(object) - links to data sets
              • self(object) - link to this data set
                • href(string) - reference
                • templated(boolean) - ability to be templated
            • id (string) - The ID of the classification's level
            • name (string) - The Name of the classification's level
            • locale (string) - Locale in which the content is returned
          • _links(object) - links to data sets
            • self(object) - link to this data set
              • href(string) - reference
              • templated(boolean) - ability to be templated
          • id (string) - The ID of the classification's level
          • name (string) - The Name of the classification's level
          • locale (string) - Locale in which the content is returned
        • primary(boolean) - True if this is the entity's primary classification
        • type(object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
          • subTypes (array) - List of Sub Types linked to the Type
            • {array item object}
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
              • locale (string) - Locale in which the content is returned
          • id (string) - The ID of the classification's level
          • name (string) - The Name of the classification's level
          • locale (string) - Locale in which the content is returned
        • subType(object) - Secondary Type to further categorize an entity (Band, Choir, Chorus, etc)
          • _links(object) - links to data sets
            • self(object) - link to this data set
              • href(string) - reference
              • templated(boolean) - ability to be templated
          • id (string) - The ID of the classification's level
          • name (string) - The Name of the classification's level
          • locale (string) - Locale in which the content is returned
        • family(boolean) - True if this is a family classification
  • page(object) - information about current page in data source
    • size(number) - size of page.
    • totalElements(number) - total number of available elements in server
    • totalPages(number) - total number of available pages in server
    • number(number) - current page number counted from 0

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/classifications.json?apikey={apikey}",
  async:true,
  dataType: "json",
  success: function(json) {
              console.log(json);
              // Parse the response.
              // Do other things.
           },
  error: function(xhr, status, err) {
              // This time, we do not end up here!
           }
});
curl \
--include 'https://app.ticketmaster.com/discovery/v2/classifications.json?apikey={apikey}'

Examples:

Request Response

GET /discovery/v2/classifications.json?apikey={apikey} HTTP/1.1
Host: app.ticketmaster.com
X-Target-URI: https://app.ticketmaster.com
Connection: Keep-Alive
HTTP/1.1 200 OK
Rate-Limit-Over: 0
Content-Length: 1093
Rate-Limit-Available: 4714
Set-Cookie: CMPS=X+EBiEvRM0syS+stL/cX/gsj/b+Ekp+ax1Y1UXwHF4W4DqB22Y2rXsf00GJCnetC; path=/
Access-Control-Max-Age: 3628800
Access-Control-Allow-Methods: GET, PUT, POST, DELETE
Connection: keep-alive
Server: Apache-Coyote/1.1
Rate-Limit-Reset: 1457417554290
Access-Control-Allow-Headers: origin, x-requested-with, accept
Date: Mon, 07 Mar 2016 10:23:47 GMT
Access-Control-Allow-Origin: *
X-Application-Context: application:local,default,jphx1:8080
Content-Type: application/json;charset=utf-8
X-Unknown-Params: apikey
X-Unknown-Params: api-key
Rate-Limit: 5000

{  
   "_links":{  
      "self":{  
         "href":"/discovery/v2/classifications.json?view=null&size=2{&page,sort}",
         "templated":true
      },
      "next":{  
         "href":"/discovery/v2/classifications.json?view=null&page=1&size=2{&sort}",
         "templated":true
      }
   },
   "_embedded":{  
      "classifications":[  
         {  
            "_links":{  
               "self":{  
                  "href":"/discovery/v2/classifications/KZFzniwnSyZfZ7v7na?locale=en-us"
               }
            },
            "segment":{  
               "id":"KZFzniwnSyZfZ7v7na",
               "name":"Arts & Theatre",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/segments/KZFzniwnSyZfZ7v7na?locale=en-us"
                  }
               },
               "_embedded":{  
                  "genres":[
                    {  
                        "id":"KnvZfZ7v7lv",
                        "name":"Magic & Illusion",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7v7lv?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7v7l7",
                                 "name":"Magic",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7v7l7?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     }
                  ]
               }
            }
         },
         {  
            "_links":{  
               "self":{  
                  "href":"/discovery/v2/classifications/KZFzniwnSyZfZ7v7nn?locale=en-us"
               }
            },
            "segment":{  
               "id":"KZFzniwnSyZfZ7v7nn",
               "name":"Film",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/segments/KZFzniwnSyZfZ7v7nn?locale=en-us"
                  }
               },
               "_embedded":{  
                  "genres":[  
                     {  
                        "id":"KnvZfZ7vAka",
                        "name":"Miscellaneous",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAka?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vFll",
                                 "name":"Classic/Reissue",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFll?locale=en-us"
                                    }
                                 }
                              },
                              {  
                                 "id":"KZazBEonSMnZfZ7vFln",
                                 "name":"Miscellaneous",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFln?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAkF",
                        "name":"Family",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAkF?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vFlt",
                                 "name":"Miscellaneous",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFlt?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAk1",
                        "name":"Foreign",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAk1?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vavv",
                                 "name":"Foreign",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vavv?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAkd",
                        "name":"Animation",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAkd?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vFla",
                                 "name":"Animation",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFla?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAkE",
                        "name":"Urban",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAkE?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vavd",
                                 "name":"Urban",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vavd?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAke",
                        "name":"Action/Adventure",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAke?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vFlF",
                                 "name":"Action/Adventure",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFlF?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAkJ",
                        "name":"Music",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAkJ?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vave",
                                 "name":"Music",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vave?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAkA",
                        "name":"Comedy",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAkA?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vFlJ",
                                 "name":"Comedy",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFlJ?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAk7",
                        "name":"Arthouse",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAk7?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vFl1",
                                 "name":"Arthouse",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFl1?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAk6",
                        "name":"Drama",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAk6?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vFlI",
                                 "name":"Drama",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFlI?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     },
                     {  
                        "id":"KnvZfZ7vAkk",
                        "name":"Documentary",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/genres/KnvZfZ7vAkk?locale=en-us"
                           }
                        },
                        "_embedded":{  
                           "subgenres":[  
                              {  
                                 "id":"KZazBEonSMnZfZ7vFlE",
                                 "name":"Documentary",
                                 "_links":{  
                                    "self":{  
                                       "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFlE?locale=en-us"
                                    }
                                 }
                              }
                           ]
                        }
                     }
                  ]
               }
            }
         }
      ]
   },
   "page":{  
      "size":2,
      "totalElements":6,
      "totalPages":3,
      "number":0
   }
}

Get Classification Details

Method: GET

Summary: Get Classification Details

Description: Get details for a specific segment, genre, or sub-genre using its unique identifier.

/discovery/v2/classifications/{id}

URL parameters:

Parameter Description Type Default Value Required
id ID of the segment, genre, or sub-genre String Yes

Query parameters:

Parameter Description Type Default Value Required
locale 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,*') String en No
domain Filter entities based on domains they are available on Array No

Response structure:

200 successful operation

  • _links(object) - links to data sets
    • self(object) - link to this data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
  • segment(object) - A Segment is a primary genre for an entity (Music, Sports, Arts, etc)
    • _embedded(object) - container for genres.
      • genres(object) - Classification
        • {array item object}
          • _embedded(object) - container for subgenres.
            • subgenres(object) - Tertiary Genre for additional detail when describring an entity (Alternative Rock, Ambient Pop, etc)
              • {array item object}
                • _links(object) - links to data sets
                  • self(object) - link to this data set
                    • href(string) - reference
                    • templated(boolean) - ability to be templated
                • id (string) - The ID of the classification's level
                • name (string) - The Name of the classification's level
                • locale (string) - Locale in which the content is returned
          • _links(object) - links to data sets
            • self(object) - link to this data set
              • href(string) - reference
              • templated(boolean) - ability to be templated
          • id (string) - The ID of the classification's level
          • name (string) - The Name of the classification's level
          • locale (string) - Locale in which the content is returned
        • _links(object) - links to data sets
          • self(object) - link to this data set
            • href(string) - reference
            • templated(boolean) - ability to be templated
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
      • _links(object) - links to data sets
        • self(object) - link to this data set
          • href(string) - reference
          • templated(boolean) - ability to be templated
      • id (string) - The ID of the classification's level
      • name (string) - The Name of the classification's level
      • locale (string) - Locale in which the content is returned
    • _links(object) - links to data sets
      • self(object) - link to this data set
        • href(string) - reference
        • templated(boolean) - ability to be templated
    • id (string) - The ID of the classification's level
    • name (string) - The Name of the classification's level
    • locale (string) - Locale in which the content is returned
  • primary(boolean) - True if this is the entity's primary classification
  • type(object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
    • subTypes (array) - List of Sub Types linked to the Type
      • {array item object}
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
    • id (string) - The ID of the classification's level
    • name (string) - The Name of the classification's level
    • locale (string) - Locale in which the content is returned
  • subType(object) - Secondary Type to further categorize an entity (Band, Choir, Chorus, etc)
    • _links(object) - links to data sets
      • self(object) - link to this data set
        • href(string) - reference
        • templated(boolean) - ability to be templated
    • id (string) - The ID of the classification's level
    • name (string) - The Name of the classification's level
    • locale (string) - Locale in which the content is returned
  • family(boolean) - True if this is a family classification

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/classifications/KZFzniwnSyZfZ7v7nE.json?apikey={apikey}",
  async:true,
  dataType: "json",
  success: function(json) {
              console.log(json);
              // Parse the response.
              // Do other things.
           },
  error: function(xhr, status, err) {
              // This time, we do not end up here!
           }
});
curl \
--include 'https://app.ticketmaster.com/discovery/v2/classifications/KZFzniwnSyZfZ7v7nE.json?apikey={apikey}'

Examples:

Request Response

GET /discovery/v2/classifications/KZFzniwnSyZfZ7v7nE?apikey={apikey} HTTP/1.1
Host: app.ticketmaster.com
X-Target-URI: https://app.ticketmaster.com
Connection: Keep-Alive
HTTP/1.1 200 OK
Rate-Limit-Over: 0
Content-Length: 146
Rate-Limit-Available: 4704
Set-Cookie: CMPS=knuzxOVcqdhMvUWKhD1HJcR5XXSZVELJc0IG2tQ2a6fPIMvDGc3jQaIZwf8n3jmw; path=/
Access-Control-Max-Age: 3628800
Access-Control-Allow-Methods: GET, PUT, POST, DELETE
Connection: keep-alive
Server: Apache-Coyote/1.1
Rate-Limit-Reset: 1457417554290
Access-Control-Allow-Headers: origin, x-requested-with, accept
Date: Mon, 07 Mar 2016 10:33:15 GMT
Access-Control-Allow-Origin: *
X-Application-Context: application:local,default,jphx1:8080
Content-Type: application/json;charset=utf-8
X-Unknown-Params: apikey
X-Unknown-Params: api-key
Rate-Limit: 5000

{  
   "_links":{  
      "self":{  
         "href":"/discovery/v2/classifications/KZFzniwnSyZfZ7v7nE?locale=en-us"
      }
   },
   "segment":{  
      "id":"KZFzniwnSyZfZ7v7nE",
      "name":"Sports",
      "_links":{  
         "self":{  
            "href":"/discovery/v2/classifications/segments/KZFzniwnSyZfZ7v7nE?locale=en-us"
         }
      },
      "_embedded":{  
         "genres":[  
            {  
               "id":"KnvZfZ7vA76",
               "name":"Netball",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA76?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFtA",
                        "name":"Netball",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtA?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7k",
               "name":"Motorsports/Racing",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7k?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFt7",
                        "name":"Motorsports/Racing",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFt7?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7a",
               "name":"Roller Hockey",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7a?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFtF",
                        "name":"Roller Hockey",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtF?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAea",
               "name":"Rodeo",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAea?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFtk",
                        "name":"Bullriding",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtk?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vF1d",
                        "name":"Rodeo",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vF1d?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA71",
               "name":"Rugby",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA71?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFta",
                        "name":"Rugby",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFta?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFt1",
                        "name":"Rugby League",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFt1?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFtJ",
                        "name":"Rugby Union",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtJ?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7v",
               "name":"Ice Skating",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7v?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFIF",
                        "name":"Ice Skating",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIF?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7d",
               "name":"Martial Arts",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7d?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFIJ",
                        "name":"Kickboxing",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIJ?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFI1",
                        "name":"Karate",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFI1?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFIE",
                        "name":"Mixed Martial Arts",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIE?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7e",
               "name":"Indoor Soccer",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7e?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFIa",
                        "name":"Indoor Soccer",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIa?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7A",
               "name":"Miscellaneous",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7A?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFtv",
                        "name":"High School",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtv?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFIl",
                        "name":"GAA",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIl?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFIt",
                        "name":"Miscellaneous",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIt?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFte",
                        "name":"College",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFte?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFtd",
                        "name":"Minor League",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtd?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA77",
               "name":"Lacrosse",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA77?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFII",
                        "name":"Lacrosse",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFII?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAet",
               "name":"Athletic Races",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAet?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vF11",
                        "name":"Athletic Races",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vF11?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7l",
               "name":"Table Tennis",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7l?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFne",
                        "name":"Table Tennis",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFne?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAeI",
               "name":"Aquatics",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAeI?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vF1a",
                        "name":"Aquatics",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vF1a?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7n",
               "name":"Swimming",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7n?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFnv",
                        "name":"Swimming",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFnv?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAel",
               "name":"Bandy",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAel?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vF1E",
                        "name":"Bandy",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vF1E?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAen",
               "name":"Badminton",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAen?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vF1J",
                        "name":"Badminton",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vF1J?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7E",
               "name":"Soccer",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7E?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFtI",
                        "name":"MLS",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtI?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFtt",
                        "name":"Soccer",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtt?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7J",
               "name":"Ski Jumping",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7J?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFtE",
                        "name":"Ski Jumping",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtE?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7t",
               "name":"Surfing",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7t?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFtl",
                        "name":"Surfing",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtl?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vA7I",
               "name":"Squash",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vA7I?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFtn",
                        "name":"Squash",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFtn?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdk",
               "name":"Cricket",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdk?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFJE",
                        "name":"Cricket",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJE?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdA",
               "name":"Boxing",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdA?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFJJ",
                        "name":"Boxing",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJJ?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdF",
               "name":"Curling",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdF?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFJl",
                        "name":"Curling",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJl?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAd6",
               "name":"Skiing",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAd6?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFJI",
                        "name":"Cross Country",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJI?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFJt",
                        "name":"Nordic Combined",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJt?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFJn",
                        "name":"Skiing",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJn?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAd1",
               "name":"Equestrian",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAd1?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFEe",
                        "name":"Dressage",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEe?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFEd",
                        "name":"Equestrian",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEd?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFE7",
                        "name":"Horse Racing",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFE7?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAda",
               "name":"Cycling",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAda?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFEv",
                        "name":"Cycling",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEv?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAAe",
               "name":"Toros",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAAe?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFn7",
                        "name":"Toros",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFn7?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAAv",
               "name":"Tennis",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAAv?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFnd",
                        "name":"Tennis",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFnd?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAde",
               "name":"Basketball",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAde?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFJ6",
                        "name":"Men Professional",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJ6?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFJ7",
                        "name":"NBDL",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJ7?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFJd",
                        "name":"Minor League",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJd?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFJA",
                        "name":"NBA",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJA?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFJF",
                        "name":"WNBA",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJF?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFJv",
                        "name":"College",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJv?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFJe",
                        "name":"High School",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJe?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFJk",
                        "name":"NBL",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJk?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFn1",
                        "name":"NBA D League",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFn1?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFnJ",
                        "name":"Women Professional",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFnJ?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAA7",
               "name":"Volleyball",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAA7?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFnk",
                        "name":"Minor League",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFnk?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFn6",
                        "name":"Volleyball",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFn6?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdv",
               "name":"Baseball",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdv?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vF1t",
                        "name":"Minor League",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vF1t?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vF1l",
                        "name":"Professional",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vF1l?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vF1I",
                        "name":"College",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vF1I?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vF1n",
                        "name":"MLB",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vF1n?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAAd",
               "name":"Track & Field",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAAd?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFnA",
                        "name":"Track & Field",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFnA?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAd7",
               "name":"Body Building",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAd7?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFJ1",
                        "name":"Body Building",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJ1?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAAk",
               "name":"Wrestling",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAAk?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFna",
                        "name":"Wrestling",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFna?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdd",
               "name":"Biathlon",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdd?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFJa",
                        "name":"Biathlon",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFJa?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAAA",
               "name":"Waterpolo",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAAA?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFnF",
                        "name":"Waterpolo",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFnF?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdn",
               "name":"Gymnastics",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdn?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFIk",
                        "name":"Gymnastics",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIk?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdt",
               "name":"Golf",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdt?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFI7",
                        "name":"PGA Tour",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFI7?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFId",
                        "name":"PGA B-Tour",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFId?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFIv",
                        "name":"Golf",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIv?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFIe",
                        "name":"LPGA",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIe?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFIA",
                        "name":"PGA Senior Tour",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFIA?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdl",
               "name":"Handball",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdl?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFI6",
                        "name":"Handball",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFI6?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdJ",
               "name":"Extreme",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdJ?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFEA",
                        "name":"Extreme",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEA?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdI",
               "name":"Hockey",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdI?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFEl",
                        "name":"Ice Hockey",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEl?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFEE",
                        "name":"NHL",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEE?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFEI",
                        "name":"College",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEI?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFEt",
                        "name":"Minor League",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEt?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFEn",
                        "name":"Professional",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEn?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            },
            {  
               "id":"KnvZfZ7vAdE",
               "name":"Football",
               "_links":{  
                  "self":{  
                     "href":"/discovery/v2/classifications/genres/KnvZfZ7vAdE?locale=en-us"
                  }
               },
               "_embedded":{  
                  "subgenres":[  
                     {  
                        "id":"KZazBEonSMnZfZ7vFEk",
                        "name":"AFL",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEk?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFE1",
                        "name":"NFL",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFE1?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFEa",
                        "name":"High School",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEa?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFE6",
                        "name":"College",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFE6?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFEJ",
                        "name":"Professional",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEJ?locale=en-us"
                           }
                        }
                     },
                     {  
                        "id":"KZazBEonSMnZfZ7vFEF",
                        "name":"International Rules",
                        "_links":{  
                           "self":{  
                              "href":"/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFEF?locale=en-us"
                           }
                        }
                     }
                  ]
               }
            }
         ]
      }
   }
}

Get Genre Details

Method: GET

Summary: Get Genre Details

Description: Get details for a specific genre using its unique identifier.

/discovery/v2/classifications/genres/{id}

URL parameters:

Parameter Description Type Default Value Required
id ID of the genre String Yes

Query parameters:

Parameter Description Type Default Value Required
locale 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,*') String en No
domain Filter entities based on domains they are available on Array No

Response structure:

200 successful operation

  • _links(object) - links to data sets
    • self(object) - link to this data set
      • href(string) - reference
      • templated(boolean) - ability to be templated
  • _embedded(object) - container
    • subgenres(array) - related
      • {array item object}
        • _links(object) - links to data sets
          • self(object) - link to this data set
            • href(string) - reference
            • templated(boolean) - ability to be templated
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
        • locale (string) - Locale in which the content is returned
  • subGenres(array) - List of Tertiary Genre linked to the Secondary Genre
    • { array item object }
      • id (string) - The ID of the classification's level
      • name (string) - The Name of the classification's level
      • locale (string) - Locale in which the content is returned
  • id(string) - The ID of the classification's level