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}

Event Search

Method: GET

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 events by attraction id String No
venueId Filter events by venue id String No
postalCode Filter events 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 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 events by market id String No
startDateTime Filter events with a start date after this date String No
endDateTime Filter events with a start date before this date String No
includeTBA True, to include events with date to be announce (TBA) String enum:["yes", " no", " only"] no if date parameter sent, yes otherwise No
includeTBD True, to include event 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' String relevance,desc No
onsaleStartDateTime Filter events with onsale start date after this date String No
onsaleEndDateTime Filter events with onsale end date before this date String No
city Filter events by city String No
countryCode Filter events by country code String No
stateCode Filter events by state code String No
classificationName Filter events by classification name: name of any segment, genre, sub-genre, type, sub-type Array No
classificationId Filter events 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 events by dma id String No
onsaleOnStartDate Filter events with onsale start date on this date String No
onsaleOnAfterStartDate Filter events with onsale range within this date String No
segmentId Filter events by segment id String No
segmentName Filter events by segment name String No
promoterId Filter events by promoter id String No
clientVisibility Filter events by clientName String No
geoPoint filter events by geoHash String No
includeLicensedContent Yes if you want to display licensed content String enum:["yes", " no"] no No
includeSpellcheck yes, to include spell check suggestions in the response. String enum:["yes", " no"] no No

Response structure:

  • _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
              • 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
                    • {array item object}
                      • type (string)
              • 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
              • upcomingEvents (object) - number of upcoming events
          • 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)
                    • id (string) - The ID of the classification's level
                    • name (string) - The Name of the classification's level
                  • 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
                  • 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
                  • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
                    • id (string) - The ID of the classification's level
                    • name (string) - The Name of the classification's level
                  • 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
              • 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
              • 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)
                  • rangeDurationField (object)
                    • precise (boolean)
                    • unitMillis (integer) - int64
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • durationField (object)
                    • precise (boolean)
                    • unitMillis (integer) - int64
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • minimumValue (integer) - int32
                  • maximumValue (integer) - int32
                  • leapDurationField (object)
                    • precise (boolean)
                    • unitMillis (integer) - int64
                    • 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)
                  • rangeDurationField (object)
                    • precise (boolean)
                    • unitMillis (integer) - int64
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • durationField (object)
                    • precise (boolean)
                    • unitMillis (integer) - int64
                    • name (string)
                    • type (object)
                      • name (string)
                    • supported (boolean)
                  • minimumValue (integer) - int32
                  • maximumValue (integer) - int32
                  • leapDurationField (object)
                    • precise (boolean)
                    • unitMillis (integer) - int64
                    • 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
        • 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)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
            • 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
            • 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
            • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
            • 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
        • 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
  • 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}'

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

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
includeLicensedContent True if you want to display licensed content String enum:["yes", " no"] no No

Response structure:

  • _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
              • {array item object}
                • type (string)
        • 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
        • upcomingEvents (object) - number of upcoming events
    • 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)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
            • 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
            • 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
            • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
            • 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
        • 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
        • 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)
            • rangeDurationField (object)
              • precise (boolean)
              • unitMillis (integer) - int64
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • durationField (object)
              • precise (boolean)
              • unitMillis (integer) - int64
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • minimumValue (integer) - int32
            • maximumValue (integer) - int32
            • leapDurationField (object)
              • precise (boolean)
              • unitMillis (integer) - int64
              • 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)
            • rangeDurationField (object)
              • precise (boolean)
              • unitMillis (integer) - int64
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • durationField (object)
              • precise (boolean)
              • unitMillis (integer) - int64
              • name (string)
              • type (object)
                • name (string)
              • supported (boolean)
            • minimumValue (integer) - int32
            • maximumValue (integer) - int32
            • leapDurationField (object)
              • precise (boolean)
              • unitMillis (integer) - int64
              • 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
  • 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)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
      • 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
      • 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
      • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
      • 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
  • 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

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}'

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

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
includeLicensedContent True if you want to display licensed content String enum:["yes", " no"] no No

Response structure:

  • _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}'

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

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 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
includeLicensedContent Yes if you want to display licensed content String enum:["yes", " no"] no No
includeSpellcheck yes, to include spell check suggestions in the response. String enum:["yes", " no"] no No

Response structure:

  • _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)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
            • 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
            • 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
            • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
              • id (string) - The ID of the classification's level
              • name (string) - The Name of the classification's level
            • 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
        • 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
        • 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}'

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

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
includeLicensedContent True if you want to display licensed content String enum:["yes", " no"] no No

Response structure:

  • _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)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
      • 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
      • 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
      • type (object) - A Type represents a kind or group of people. (Donation, Group, Individual, Merchandise, Event Style, etc)
        • id (string) - The ID of the classification's level
        • name (string) - The Name of the classification's level
      • 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
  • 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
  • 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}'

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

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 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
includeLicensedContent Yes if you want to display licensed content String enum:["yes", " no"] no No
includeSpellcheck yes, to include spell check suggestions in the response. String enum:["yes", " no"] no No

Response structure:

  • _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
                • _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
              • _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
            • _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
          • _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
        • 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)
          • _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
        • 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
  • 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}'

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

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
includeLicensedContent True if you want to display licensed content String enum:["yes", " no"] no No

Response structure:

  • _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
          • _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
        • _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
      • _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
    • _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
  • 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)
    • _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
  • 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

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}'

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

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
includeLicensedContent True if you want to display licensed content String enum:["yes", " no"] no No

Response structure:

  • _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
  • id (string) - The ID of the classification's level
  • name (string) - The Name of the classification's level

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/classifications/genres/KnvZfZ7vA71.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/genres/KnvZfZ7vA71.json?apikey={apikey}'

Request Response

GET /discovery/v2/classifications/genres/KnvZfZ7vA71.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
Access-Control-Allow-Headers:origin, x-requested-with, accept
Access-Control-Allow-Methods:GET, PUT, POST, DELETE
Access-Control-Allow-Origin:*
Access-Control-Max-Age:3628800
Connection:keep-alive
Content-Length:605
Content-Type:application/hal+json;charset=utf-8
Date:Tue, 20 Sep 2016 10:39:15 GMT
Rate-Limit:5000
Rate-Limit-Available:1654
Rate-Limit-Over:0
Rate-Limit-Reset:1474384903781
Server:Apache-Coyote/1.1
X-Application-Context:application:local,default,jphx1:8080
X-TM-GTM-Origin:uapi-us-phx2

{
  "_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"
          }
        }
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/discovery/v2/classifications/genres/KnvZfZ7vA71?locale=en-us"
    }
  },
  "id": "KnvZfZ7vA71",
  "name": "Rugby"
}

Get Segment Details

Method: GET

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

/discovery/v2/classifications/segments/{id}

URL parameters:

Parameter Description Type Default Value Required
id ID of the segment 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
includeLicensedContent True if you want to display licensed content String enum:["yes", " no"] no No

Response structure:

  • _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 for genres.
    • genres(object) - Segment
      • {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
        • _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
      • _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
  • id (string) - The ID of the classification's level
  • name (string) - The Name of the classification's level

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/classifications/segments/KZazBEonSMnZfZ7vFta.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/segments/KZazBEonSMnZfZ7vFta.json?apikey={apikey}'

Request Response

GET /discovery/v2/classifications/segments/KZazBEonSMnZfZ7vFta.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
Access-Control-Allow-Headers:origin, x-requested-with, accept
Access-Control-Allow-Methods:GET, PUT, POST, DELETE
Access-Control-Allow-Origin:*
Access-Control-Max-Age:3628800
Connection:keep-alive
Content-Length:469
Content-Type:application/json;charset=utf-8
Date:Tue, 20 Sep 2016 11:21:54 GMT
Rate-Limit:5000
Rate-Limit-Available:1514
Rate-Limit-Over:0
Rate-Limit-Reset:1474384903781
Server:Apache-Coyote/1.1
Set-Cookie:CMPS=bpb3Bk6rqZf1d8yLiJWyOiPc1IunRq4KdVq9OqS25+BMCRNts5X3I7p9SbevsS6OttgINJhrlh4=; path=/
X-Application-Context:application:local,default,jphx1:8080

{
  "id": "KZFzniwnSyZfZ7v7nE",
  "name": "Sports",
  "_links": {
    "self": {
      "href": "/discovery/v2/classifications/segments/KZFzniwnSyZfZ7v7nE?locale=en-us"
    }
  },
  "_embedded": {
    "genres": [
      {
        "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"
                }
              }
            }
          ]
        }
      }
    ]
  }
}

Get Sub-Genre Details

Method: GET

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

/discovery/v2/classifications/subgenres/{id}

URL parameters:

Parameter Description Type Default Value Required
id ID of the subgenre 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
includeLicensedContent True if you want to display licensed content String enum:["yes", " no"] no No

Response structure:

  • _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

JavaScript cURL

$.ajax({
  type:"GET",
  url:"https://app.ticketmaster.com/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFta.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/subgenres/KZazBEonSMnZfZ7vFta.json?apikey={apikey}'

Request Response

GET /discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFta.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
Access-Control-Allow-Headers:origin, x-requested-with, accept
Access-Control-Allow-Methods:GET, PUT, POST, DELETE
Access-Control-Allow-Origin:*
Access-Control-Max-Age:3628800
Connection:keep-alive
Content-Length:145
Content-Type:application/json;charset=utf-8
Date:Tue, 20 Sep 2016 11:27:24 GMT
Rate-Limit:5000
Rate-Limit-Available:1498
Rate-Limit-Over:0
Rate-Limit-Reset:1474384903781
Server:Apache-Coyote/1.1
X-Application-Context:application:local,default,jphx1:8080
X-TM-GTM-Origin:uapi-us-phx2

{
  "_links": {
    "self": {
      "href": "/discovery/v2/classifications/subgenres/KZazBEonSMnZfZ7vFta?locale=en-us"
    }
  },
  "id": "KZazBEonSMnZfZ7vFta",
  "name": "Rugby"
}

Venue Search

Method: GET

Description: Find venues and filter your search by name, and much more.

/discovery/v2/venues

Query parameters:

Parameter Description Type Default Value Required
id Filter entities by its id String No
keyword Keyword to search on 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 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', 'distance,asc', 'distance,desc' String relevance,desc No
countryCode Filter venues by country code String No
stateCode Filter venues by state / province code String No
geoPoint filter events by geoHash String No
includeLicensedContent Yes if you want to display licensed content String enum:["yes", " no"] no No
includeSpellcheck yes, to include spell check suggestions in the response. String enum:["yes", " no"] no No

Response structure:

  • _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
    • venues(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
        • distance (number) - double
        • units (string) - No description specified
        • 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
              • {array item object}
                • type (string)
        • 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
        • 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/venues.json?keyword=UCV&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/venues.json?keyword=UCV&apikey={apikey}'

Request Response

GET /discovery/v2/venues.json?apikey={apikey}&keyword=UCV HTTP/1.1
Host: app.ticketmaster.com
X-Target-URI: http://app.ticketmaster.com
Connection: Keep-Alive
HTTP/1.1 200 OK
Rate-Limit-Over: 0
Content-Length: 1241
Rate-Limit-Available: 4646
Set-Cookie: CMPS=5Gk5wt8nfXBXXBiKtbkBiPSHgfZp9zC9Gv5MPAEcFsr5g6kwuwchDenPMUm/k7jxtKdE9AU0WRI=; 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 12:07:21 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

{
  "_embedded": {
    "venues": [
      {
        "_links": {
          "self": {
            "href": "/discovery/v2/venues/KovZpZAFnIEA?locale=en-us"
          }
        },
        "address": {
          "line1": "Crysler Park Marina, 13480 County Rd 2"
        },
        "city": {
          "name": "Morrisburg"
        },
        "country": {
          "name": "Canada",
          "countryCode": "CA"
        },
        "dmas": [
          {
            "id": 519
          }
        ],
        "id": "KovZpZAFnIEA",
        "locale": "en-us",
        "location": {
          "longitude": "-75.18702730",
          "latitude": "44.94535340"
        },
        "markets": [
          {
            "id": "103"
          }
        ],
        "name": "#1 Please do not use, left over from UCV initial acct set up",
        "postalCode": "K0C1X0",
        "state": {
          "name": "Ontario",
          "stateCode": "ON"
        },
        "test": false,
        "timezone": "America/Toronto",
        "type": "venue",
        "url": "http://ticketmaster.ca/venue/341396"
      },
      {
        "name": "#2 Please do not use, left over from UCV initial acct set up",
        "type": "venue",
        "id": "KovZpZAFnIJA",
        "test": false,
        "url": "http://ticketmaster.ca/venue/341395",
        "locale": "en-us",
        "postalCode": "K0C1X0",
        "timezone": "America/Toronto",
        "city": {
          "name": "Morrisburg"
        },
        "state": {
          "name": "Ontario",
          "stateCode": "ON"
        },
        "country": {
          "name": "Canada",
          "countryCode": "CA"
        },
        "address": {
          "line1": "13740 County Road 2"
        },
        "location": {
          "longitude": "-75.18635300",
          "latitude": "44.89937100"
        },
        "markets": [
          {
            "id": "103"
          }
        ],
        "dmas": [
          {
            "id": 519
          }
        ],
        "_links": {
          "self": {
            "href": "/discovery/v2/venues/KovZpZAFnIJA?locale=en-us"
          }
        }
      }
    ]
  },
  "_links": {
    "self": {
      "href": "/discovery/v2/venues.json?view=null&keyword=UCV{&page,size,sort}",
      "templated": true
    }
  },
  "page": {
    "size": 20,
    "totalElements": 2,
    "totalPages": 1,
    "number": 0
  }
}

Get Venue Details

Method: GET

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

/discovery/v2/venues/{id}

URL parameters:

Parameter Description Type Default Value Required
id ID of the venue 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
includeLicensedContent True if you want to display licensed content String enum:["yes", " no"] no No

Response structure:

  • _links(object) - links to data sets