openapi.city
Sign in

Ticketmaster

Event and ticket discovery API

developer.ticketmaster.com ↗
Version
v2
OpenAPI
3.0.0
Endpoints
13
Schemas
71
Updated
3 days ago
Entertainment entertainment events tickets
Use this API in your AI agent

Query structured spec data via REST or MCP. Get exactly what your agent needs.

Get API Key

Server URLs

//www.ticketmaster.com/discovery/v2

Authentication

apiKey

Endpoints

Clear filters
GET POST PUT PATCH DELETE

V2 13 endpoints

GET /discovery/v2/attractions

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

operationId: V2_searchAttractions

Parameters

Name In Required Type Description
sort query optional string Sorting order of the search result. Allowable Values : 'name,asc', 'name,desc', 'relevance,asc', 'relevance,desc'
classificationName query optional array Filter attractions by classification name: name of any segment, genre, sub-genre, type, sub-type
classificationId query optional array Filter attractions by classification id: id of any segment, genre, sub-genre, type, sub-type
keyword query optional string Keyword to search on
id query optional string Filter entities by its id
source query optional string Filter entities by its source name
includeTest query optional string True if you want to have entities flag as test in the response. Only, if you only wanted test entities
page query optional string Page number
size query optional string Page size of the response
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string Yes if you want to display licensed content
includeSpellcheck query optional string yes, to include spell check suggestions in the response.

Responses

200 successful operation
GET /discovery/v2/attractions
GET /discovery/v2/attractions/{id}

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

operationId: V2_getAttractionDetails

Parameters

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

Responses

200 successful operation
GET /discovery/v2/attractions/{id}
GET /discovery/v2/classifications

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

operationId: V2_searchClassifications

Parameters

Name In Required Type Description
sort query optional string Sorting order of the search result
keyword query optional string Keyword to search on
id query optional string Filter entities by its id
source query optional string Filter entities by its source name
includeTest query optional string True if you want to have entities flag as test in the response. Only, if you only wanted test entities
page query optional string Page number
size query optional string Page size of the response
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string Yes if you want to display licensed content
includeSpellcheck query optional string yes, to include spell check suggestions in the response.

Responses

200 successful operation
GET /discovery/v2/classifications
GET /discovery/v2/classifications/genres/{id}

Get details for a specific genre using its unique identifier.

operationId: V2_getGenreDetails

Parameters

Name In Required Type Description
id path required string ID of the genre
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string True if you want to display licensed content

Responses

200 successful operation
GET /discovery/v2/classifications/genres/{id}
GET /discovery/v2/classifications/segments/{id}

Get details for a specific segment using its unique identifier.

operationId: V2_getSegmentDetails

Parameters

Name In Required Type Description
id path required string ID of the segment
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string True if you want to display licensed content

Responses

200 successful operation
GET /discovery/v2/classifications/segments/{id}
GET /discovery/v2/classifications/subgenres/{id}

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

operationId: V2_getSubgenreDetails

Parameters

Name In Required Type Description
id path required string ID of the subgenre
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string True if you want to display licensed content

Responses

200 successful operation
GET /discovery/v2/classifications/subgenres/{id}
GET /discovery/v2/classifications/{id}

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

operationId: V2_getClassificationDetails

Parameters

Name In Required Type Description
id path required string ID of the segment, genre, or sub-genre
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string True if you want to display licensed content

Responses

200 successful operation
GET /discovery/v2/classifications/{id}
GET /discovery/v2/events

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

operationId: V2_eventSearch

Parameters

Name In Required Type Description
sort query optional string 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'
startDateTime query optional string Filter events with a start date after this date
endDateTime query optional string Filter events with a start date before this date
onsaleStartDateTime query optional string Filter events with onsale start date after this date
onsaleOnStartDate query optional string Filter events with onsale start date on this date
onsaleOnAfterStartDate query optional string Filter events with onsale range within this date
onsaleEndDateTime query optional string Filter events with onsale end date before this date
city query optional string Filter events by city
countryCode query optional string Filter events by country code
stateCode query optional string Filter events by state code
postalCode query optional string Filter events by postal code / zipcode
venueId query optional string Filter events by venue id
attractionId query optional string Filter events by attraction id
segmentId query optional string Filter events by segment id
segmentName query optional string Filter events by segment name
classificationName query optional array Filter events by classification name: name of any segment, genre, sub-genre, type, sub-type
classificationId query optional array Filter events by classification id: id of any segment, genre, sub-genre, type, sub-type
marketId query optional string Filter events by market id
promoterId query optional string Filter events by promoter id
dmaId query optional string Filter events by dma id
includeTBA query optional string True, to include events with date to be announce (TBA)
includeTBD query optional string True, to include event with a date to be defined (TBD)
clientVisibility query optional string Filter events by clientName
latlong query optional string Filter events by latitude and longitude, this filter is deprecated and maybe removed in a future release, please use geoPoint instead
radius query optional string Radius of the area in which we want to search for events.
unit query optional string Unit of the radius
geoPoint query optional string filter events by geoHash
keyword query optional string Keyword to search on
id query optional string Filter entities by its id
source query optional string Filter entities by its source name
includeTest query optional string True if you want to have entities flag as test in the response. Only, if you only wanted test entities
page query optional string Page number
size query optional string Page size of the response
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string Yes if you want to display licensed content
includeSpellcheck query optional string yes, to include spell check suggestions in the response.

Responses

200 successful operation
GET /discovery/v2/events
GET /discovery/v2/events/{id}

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

operationId: V2_getEventDetails

Parameters

Name In Required Type Description
id path required string ID of the event
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string True if you want to display licensed content

Responses

200 successful operation
GET /discovery/v2/events/{id}
GET /discovery/v2/events/{id}/images

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

operationId: V2_getEventImages

Parameters

Name In Required Type Description
id path required string ID of the event
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string True if you want to display licensed content

Responses

200 successful operation
GET /discovery/v2/events/{id}/images
GET /discovery/v2/suggest

Find search suggestions and filter your suggestions by location, source, etc.

operationId: V2_findSuggest

Parameters

Name In Required Type Description
keyword query optional string Keyword to search on
source query optional string Filter entities by its source name
latlong query optional string Filter events by latitude and longitude, this filter is deprecated and maybe removed in a future release, please use geoPoint instead
radius query optional string Radius of the area in which we want to search for events.
unit query optional string Unit of the radius
size query optional string Size of every entity returned in the response
includeFuzzy query optional string yes, to include fuzzy matches in the search. This has performance impact.
clientVisibility query optional string Filter events to clientName
countryCode query optional string Filter suggestions by country code
includeTBA query optional string True, to include events with date to be announce (TBA)
includeTBD query optional string True, to include event with a date to be defined (TBD)
segmentId query optional string Filter suggestions by segment id
geoPoint query optional string filter events by geoHash
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string Yes if you want to display licensed content
includeSpellcheck query optional string yes, to include spell check suggestions in the response.

Responses

200 successful operation
GET /discovery/v2/suggest
GET /discovery/v2/venues

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

operationId: V2_findVenues

Parameters

Name In Required Type Description
sort query optional string Sorting order of the search result. Allowable Values: 'name,asc', 'name,desc', 'relevance,asc', 'relevance,desc', 'distance,asc', 'distance,desc'
stateCode query optional string Filter venues by state / province code
countryCode query optional string Filter venues by country code
latlong query optional string Filter events by latitude and longitude, this filter is deprecated and maybe removed in a future release, please use geoPoint instead
radius query optional string Radius of the area in which we want to search for events.
unit query optional string Unit of the radius
geoPoint query optional string filter events by geoHash
keyword query optional string Keyword to search on
id query optional string Filter entities by its id
source query optional string Filter entities by its source name
includeTest query optional string True if you want to have entities flag as test in the response. Only, if you only wanted test entities
page query optional string Page number
size query optional string Page size of the response
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string Yes if you want to display licensed content
includeSpellcheck query optional string yes, to include spell check suggestions in the response.

Responses

200 successful operation
GET /discovery/v2/venues
GET /discovery/v2/venues/{id}

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

operationId: V2_getVenueDetails

Parameters

Name In Required Type Description
id path required string ID of the venue
locale query optional string The locale in ISO code format. Multiple comma-separated values can be provided. When omitting the country part of the code (e.g. only 'en' or 'fr') then the first matching locale is used. When using a '*' it matches all locales. '*' can only be used at the end (e.g. 'en-us,en,*')
includeLicensedContent query optional string True if you want to display licensed content

Responses

200 successful operation
GET /discovery/v2/venues/{id}

Schemas

object AccessDates 
{
  "type": "object",
  "properties": {
    "endDateTime": {
      "type": "string",
      "format": "date-time",
      "example": "yyyy-MM-ddThh-mm-ssZ",
      "x-position": 2,
      "description": "Event's end access time"
    },
    "startDateTime": {
      "type": "string",
      "format": "date-time",
      "example": "yyyy-MM-ddThh-mm-ssZ",
      "description": "Event's start access time"
    },
    "endApproximate": {
      "type": "boolean",
      "default": false,
      "example": true,
      "x-position": 3,
      "description": "Boolean flag to indicate whether or not the access end date is approximated"
    },
    "startApproximate": {
      "type": "boolean",
      "default": false,
      "x-position": 1,
      "description": "Boolean flag to indicate whether or not the access start date is approximated"
    }
  },
  "description": "Event's Access Date"
}
object Accessibility 
{
  "type": "object",
  "properties": {
    "info": {
      "type": "string",
      "x-position": 1,
      "description": "Accessibility's information"
    }
  },
  "description": "Additional information for people who experience disabilities"
}
object Address 
{
  "type": "object",
  "properties": {
    "line1": {
      "type": "string",
      "description": "Address first line"
    },
    "line2": {
      "type": "string",
      "x-position": 3,
      "description": "Address second line"
    },
    "line3": {
      "type": "string",
      "x-position": 3,
      "description": "Address third line"
    }
  },
  "description": "Address"
}
object Area 
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    }
  },
  "description": "Area"
}
object Attraction 
{
  "type": "object",
  "required": [
    "id",
    "type"
  ],
  "properties": {
    "id": {
      "type": "string",
      "x-position": 1,
      "description": "Unique id of the entity in the discovery API"
    },
    "url": {
      "type": "string",
      "x-position": 24,
      "description": "URL of a web site detail page of the entity"
    },
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    },
    "test": {
      "type": "boolean",
      "default": false,
      "x-position": 96,
      "description": "Indicate if this is a test entity, by default test entities won't appear in discovery API"
    },
    "type": {
      "enum": [
        "event",
        "venue",
        "attraction"
      ],
      "type": "string",
      "description": "Type of the entity"
    },
    "images": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Image"
      },
      "x-position": 29,
      "description": "Images of the entity",
      "uniqueItems": true
    },
    "locale": {
      "type": "string",
      "x-position": 3,
      "description": "Locale in which the content is returned"
    },
    "description": {
      "type": "string",
      "x-position": 20,
      "description": "Description's of the entity"
    },
    "externalLinks": {
      "type": "object",
      "x-position": 79,
      "description": "List of external links",
      "additionalProperties": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ExternalLink"
        }
      }
    },
    "additionalInfo": {
      "type": "string",
      "x-position": 22,
      "description": "Additional information of the entity"
    },
    "upcomingEvents": {
      "type": "object",
      "x-position": 110,
      "description": "number of upcoming events",
      "additionalProperties": {
        "type": "integer",
        "format": "int32"
      }
    },
    "classifications": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Classification"
      },
      "x-position": 30,
      "description": "Attraction's classifications"
    }
  },
  "description": "Attraction"
}
object AttractionExtensions 
{
  "type": "object",
  "description": "All Attraction's extensions"
}
object Attribution 
{
  "type": "object",
  "properties": {
    "sourceUrl": {
      "type": "string",
      "description": "SourceUrl"
    },
    "licenceUrl": {
      "type": "string",
      "description": "LicenceUrl"
    },
    "sourceName": {
      "type": "string",
      "description": "SourceName"
    },
    "licenceName": {
      "type": "string",
      "description": "LicenceName"
    }
  },
  "description": "Attribution"
}
object Attributions 
{
  "type": "object",
  "properties": {
    "description": {
      "$ref": "#/components/schemas/Attribution"
    },
    "descriptions": {
      "type": "object",
      "description": "Attribution descriptions - multi-lingual fields",
      "additionalProperties": {
        "$ref": "#/components/schemas/Attribution"
      }
    }
  },
  "description": "Attributions"
}
object Chronology 
{
  "type": "object",
  "properties": {
    "zone": {
      "$ref": "#/components/schemas/DateTimeZone"
    }
  }
}
object City 
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    }
  },
  "description": "City"
}
object Classification 
{
  "type": "object",
  "properties": {
    "type": {
      "$ref": "#/components/schemas/Level"
    },
    "genre": {
      "$ref": "#/components/schemas/Level"
    },
    "primary": {
      "type": "boolean",
      "default": false,
      "description": "True if this is the entity's primary classification"
    },
    "segment": {
      "$ref": "#/components/schemas/Segment"
    },
    "subType": {
      "$ref": "#/components/schemas/Level"
    },
    "subGenre": {
      "$ref": "#/components/schemas/Level"
    }
  },
  "description": "Classification"
}
object Country 
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    },
    "countryCode": {
      "type": "string",
      "description": "Country code (ISO 3166)"
    }
  },
  "description": "Country"
}
object DateTimeField 
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "type": {
      "$ref": "#/components/schemas/DateTimeFieldType"
    },
    "lenient": {
      "type": "boolean",
      "default": false
    },
    "supported": {
      "type": "boolean",
      "default": false
    },
    "maximumValue": {
      "type": "integer",
      "format": "int32"
    },
    "minimumValue": {
      "type": "integer",
      "format": "int32"
    },
    "durationField": {
      "$ref": "#/components/schemas/DurationField"
    },
    "leapDurationField": {
      "$ref": "#/components/schemas/DurationField"
    },
    "rangeDurationField": {
      "$ref": "#/components/schemas/DurationField"
    }
  }
}
object DateTimeFieldType 
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "durationType": {
      "$ref": "#/components/schemas/DurationFieldType"
    },
    "rangeDurationType": {
      "$ref": "#/components/schemas/DurationFieldType"
    }
  }
}
object DateTimeZone 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "fixed": {
      "type": "boolean",
      "default": false
    }
  }
}
object DisplaySettingExtension 
{
  "type": "object",
  "properties": {
    "softLanding": {
      "type": "boolean",
      "default": false,
      "description": "True the landing is Soft otherwise it's Comingled"
    }
  },
  "description": "Event's display settings extension"
}
object Dma 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "format": "int32",
      "description": "DMS's id"
    }
  },
  "description": "DMA (Designated Market Area)"
}
object DurationField 
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "type": {
      "$ref": "#/components/schemas/DurationFieldType"
    },
    "precise": {
      "type": "boolean",
      "default": false
    },
    "supported": {
      "type": "boolean",
      "default": false
    },
    "unitMillis": {
      "type": "integer",
      "format": "int64"
    }
  }
}
object DurationFieldType 
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    }
  }
}
object EndDates 
{
  "type": "object",
  "properties": {
    "dateTime": {
      "type": "string",
      "format": "date-time",
      "example": "yyyy-MM-ddThh-mm-ssZ",
      "x-position": 2,
      "description": "The event end date time"
    },
    "localDate": {
      "type": "string",
      "format": "date",
      "example": "yyyy-MM-dd",
      "description": "The event end date in local date"
    },
    "localTime": {
      "$ref": "#/components/schemas/LocalTime"
    },
    "approximate": {
      "type": "boolean",
      "default": false,
      "x-position": 3,
      "description": "Boolean flag to indicate whether or not the end date is approximated"
    },
    "noSpecificTime": {
      "type": "boolean",
      "default": false,
      "x-position": 4,
      "description": "Boolean flag to indicate whether or not the event end time has no specific time"
    }
  },
  "description": "Event's End Dates"
}
object EntityChanges 
{
  "type": "object",
  "properties": {
    "changes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "newlyCreated": {
      "type": "boolean",
      "default": false
    }
  }
}
object Event 
{
  "type": "object",
  "required": [
    "id",
    "type"
  ],
  "properties": {
    "id": {
      "type": "string",
      "x-position": 1,
      "description": "Unique id of the entity in the discovery API"
    },
    "url": {
      "type": "string",
      "x-position": 24,
      "description": "URL of a web site detail page of the entity"
    },
    "info": {
      "type": "string",
      "x-position": 32,
      "description": "Any information related to the event"
    },
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    },
    "test": {
      "type": "boolean",
      "default": false,
      "x-position": 96,
      "description": "Indicate if this is a test entity, by default test entities won't appear in discovery API"
    },
    "type": {
      "enum": [
        "event",
        "venue",
        "attraction"
      ],
      "type": "string",
      "description": "Type of the entity"
    },
    "dates": {
      "$ref": "#/components/schemas/EventDates"
    },
    "place": {
      "$ref": "#/components/schemas/Place"
    },
    "sales": {
      "$ref": "#/components/schemas/EventSalesDates"
    },
    "units": {
      "type": "string"
    },
    "images": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Image"
      },
      "x-position": 29,
      "description": "Images of the entity",
      "uniqueItems": true
    },
    "locale": {
      "type": "string",
      "x-position": 3,
      "description": "Locale in which the content is returned"
    },
    "outlets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Outlet"
      },
      "x-position": 37,
      "description": "Related outlets informations"
    },
    "seatmap": {
      "$ref": "#/components/schemas/SeatMap"
    },
    "distance": {
      "type": "number",
      "format": "double"
    },
    "location": {
      "$ref": "#/components/schemas/Location"
    },
    "products": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Product"
      },
      "x-position": 38,
      "description": "Related products informations"
    },
    "promoter": {
      "$ref": "#/components/schemas/Promoter"
    },
    "promoters": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Promoter"
      },
      "x-position": 37,
      "description": "Event's promoters"
    },
    "pleaseNote": {
      "type": "string",
      "x-position": 34,
      "description": "Any notes related to the event"
    },
    "description": {
      "type": "string",
      "x-position": 20,
      "description": "Description's of the entity"
    },
    "priceRanges": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/PriceRange"
      },
      "x-position": 36,
      "description": "Price ranges of this event",
      "uniqueItems": true
    },
    "accessibility": {
      "$ref": "#/components/schemas/Accessibility"
    },
    "externalLinks": {
      "type": "object",
      "x-position": 79,
      "description": "List of external links",
      "additionalProperties": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ExternalLink"
        }
      }
    },
    "additionalInfo": {
      "type": "string",
      "x-position": 22,
      "description": "Additional information of the entity"
    },
    "classifications": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Classification"
      },
      "x-position": 50,
      "description": "Event's classifications"
    }
  },
  "description": "Event"
}
object EventDates 
{
  "type": "object",
  "properties": {
    "end": {
      "$ref": "#/components/schemas/EndDates"
    },
    "start": {
      "$ref": "#/components/schemas/StartDates"
    },
    "access": {
      "$ref": "#/components/schemas/AccessDates"
    },
    "status": {
      "$ref": "#/components/schemas/EventStatus"
    },
    "timezone": {
      "type": "string",
      "x-position": 3,
      "description": "Event's timezone"
    },
    "spanMultipleDays": {
      "type": "boolean",
      "default": false,
      "x-position": 5,
      "description": "Flag indicating if date spans of multiple days"
    }
  },
  "description": "Event's Dates"
}
object EventExtensions 
{
  "type": "object",
  "description": "All Event's extensions"
}
object EventImages 
{
  "type": "object",
  "required": [
    "id",
    "type"
  ],
  "properties": {
    "id": {
      "type": "string",
      "x-position": 1,
      "description": "Unique id of the entity in the discovery API"
    },
    "type": {
      "enum": [
        "event"
      ],
      "type": "string",
      "description": "Type of the entity"
    },
    "images": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Image"
      },
      "x-position": 2,
      "description": "Images of the entity",
      "uniqueItems": true
    }
  },
  "description": "This class defines an Event with only images view on the Discovery API"
}
object EventSalesDates 
{
  "type": "object",
  "properties": {
    "public": {
      "$ref": "#/components/schemas/PublicSaleDates"
    },
    "presales": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Presale"
      },
      "x-position": 1,
      "description": "Presale information on this event"
    }
  },
  "description": "Event's Sales Dates"
}
object EventStatus 
{
  "type": "object",
  "properties": {
    "code": {
      "enum": [
        "onsale",
        "offsale",
        "canceled",
        "postponed",
        "rescheduled"
      ],
      "type": "string",
      "description": "The event's status code"
    }
  },
  "description": "Event's Status"
}
object Extension 
{
  "type": "object"
}
object ExternalLink 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "x-position": 2,
      "description": "An external link id is the unique identifier of a resource on a different domain or api"
    },
    "url": {
      "type": "string",
      "x-position": 2,
      "description": "An external link url is a url that goes to a different domain or api"
    }
  },
  "description": "ExternalLink"
}
object Genre 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the classification's level"
    },
    "name": {
      "type": "string",
      "x-position": 1,
      "description": "The Name of the classification's level"
    }
  },
  "description": "Secondary Genre"
}
object GeocodeExtension 
{
  "type": "object",
  "properties": {
    "city": {
      "type": "string"
    },
    "route": {
      "type": "string"
    },
    "state": {
      "type": "string"
    },
    "county": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "geometry": {
      "$ref": "#/components/schemas/Geometry"
    },
    "postalCode": {
      "type": "string"
    },
    "streetNumber": {
      "type": "string"
    },
    "formattedAddress": {
      "type": "string"
    }
  }
}
object GeolocationVenueExtensions 
{
  "type": "object",
  "properties": {
    "geocode": {
      "$ref": "#/components/schemas/GeocodeExtension"
    }
  },
  "description": "Venue's geocode extension"
}
object Geometry 
{
  "type": "object",
  "properties": {
    "location": {
      "$ref": "#/components/schemas/Location"
    }
  }
}
object HostExtension 
{
  "type": "object",
  "description": "Event's Host extension"
}
object Image 
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "x-position": 2,
      "description": "Public URL of the image"
    },
    "ratio": {
      "enum": [
        169,
        32,
        43
      ],
      "type": "integer",
      "x-position": 3,
      "description": "Aspect ratio of the image"
    },
    "width": {
      "type": "integer",
      "format": "int32",
      "x-position": 4,
      "description": "Width of the image"
    },
    "height": {
      "type": "integer",
      "format": "int32",
      "x-position": 5,
      "description": "Height of the image"
    },
    "fallback": {
      "type": "boolean",
      "default": false,
      "x-position": 6,
      "description": "true if the image is not the event's image but a fallbak image"
    },
    "attribution": {
      "type": "string",
      "x-position": 8,
      "description": "Attribution of the image"
    }
  },
  "description": "Image"
}
object Level 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the classification's level"
    },
    "name": {
      "type": "string",
      "x-position": 1,
      "description": "The Name of the classification's level"
    }
  }
}
object LocalTime 
{
  "type": "object",
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/DateTimeField"
      }
    },
    "values": {
      "type": "array",
      "items": {
        "type": "integer",
        "format": "int32"
      }
    },
    "hourOfDay": {
      "type": "integer",
      "format": "int32"
    },
    "chronology": {
      "$ref": "#/components/schemas/Chronology"
    },
    "fieldTypes": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/DateTimeFieldType"
      }
    },
    "millisOfDay": {
      "type": "integer",
      "format": "int32"
    },
    "minuteOfHour": {
      "type": "integer",
      "format": "int32"
    },
    "millisOfSecond": {
      "type": "integer",
      "format": "int32"
    },
    "secondOfMinute": {
      "type": "integer",
      "format": "int32"
    }
  }
}
object Locale 
{
  "type": "object",
  "properties": {
    "script": {
      "type": "string"
    },
    "country": {
      "type": "string"
    },
    "variant": {
      "type": "string"
    },
    "language": {
      "type": "string"
    },
    "displayName": {
      "type": "string"
    },
    "iso3Country": {
      "type": "string"
    },
    "iso3Language": {
      "type": "string"
    },
    "displayScript": {
      "type": "string"
    },
    "extensionKeys": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "displayCountry": {
      "type": "string"
    },
    "displayVariant": {
      "type": "string"
    },
    "displayLanguage": {
      "type": "string"
    },
    "unicodeLocaleKeys": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    },
    "unicodeLocaleAttributes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "uniqueItems": true
    }
  }
}
object Location 
{
  "type": "object",
  "properties": {
    "latitude": {
      "type": "number",
      "description": "Latitude"
    },
    "longitude": {
      "type": "number",
      "description": "Longitude"
    }
  },
  "description": "Location"
}
object Market 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Market's id"
    }
  },
  "description": "Market"
}
object Outlet 
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "x-position": 1,
      "description": "Outlet's url"
    },
    "type": {
      "type": "string",
      "x-position": 2,
      "description": "Outlet's type"
    }
  },
  "description": "A selling point for tickets."
}
object Parking 
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "x-position": 20,
      "description": "Url to the web page of the parking"
    },
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    }
  },
  "description": "Parking"
}
object Place 
{
  "type": "object",
  "properties": {
    "area": {
      "$ref": "#/components/schemas/Area"
    },
    "city": {
      "$ref": "#/components/schemas/City"
    },
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    },
    "state": {
      "$ref": "#/components/schemas/State"
    },
    "address": {
      "$ref": "#/components/schemas/Address"
    },
    "country": {
      "$ref": "#/components/schemas/Country"
    },
    "location": {
      "$ref": "#/components/schemas/Location"
    },
    "postalCode": {
      "type": "string",
      "x-position": 5,
      "description": "Postal code / zipcode of the place"
    }
  },
  "description": "Place"
}
object Presale 
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "x-position": 3,
      "description": "Presale link URL"
    },
    "name": {
      "type": "string",
      "description": "Name of the presale"
    },
    "description": {
      "type": "string",
      "x-position": 1,
      "description": "Description of the presame"
    },
    "endDateTime": {
      "type": "string",
      "format": "date-time",
      "x-position": 5,
      "description": "Presale's end dates. The date and time when the presale will end"
    },
    "startDateTime": {
      "type": "string",
      "format": "date-time",
      "x-position": 4,
      "description": "Presale's start dates. The date and time when the presale will start"
    }
  },
  "description": "Event's Presale Info"
}
object PriceRange 
{
  "type": "object",
  "properties": {
    "max": {
      "type": "number",
      "format": "double",
      "x-position": 3,
      "description": "Maximum price"
    },
    "min": {
      "type": "number",
      "format": "double",
      "x-position": 2,
      "description": "Minimum price"
    },
    "type": {
      "enum": [
        "standard"
      ],
      "type": "string",
      "description": "Type of price"
    },
    "currency": {
      "type": "string",
      "x-position": 1,
      "description": "Currency"
    }
  },
  "description": "PriceRange"
}
object Product 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "x-position": 10,
      "description": "Product's primary id"
    },
    "url": {
      "type": "string",
      "x-position": 12,
      "description": "Product's url"
    },
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    },
    "type": {
      "type": "string",
      "x-position": 13,
      "description": "Product's type"
    }
  },
  "description": "Product"
}
object Promoter 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Id of the promoter"
    },
    "name": {
      "type": "string",
      "x-position": 1,
      "description": "Name of the promoter"
    },
    "description": {
      "type": "string",
      "x-position": 3,
      "description": "Description of the promoter"
    }
  },
  "description": "Promoter"
}
object PublicSaleDates 
{
  "type": "object",
  "properties": {
    "startTBD": {
      "type": "boolean",
      "default": false,
      "x-position": 2,
      "description": "True if the public sale's date is to be determined"
    },
    "endDateTime": {
      "type": "string",
      "format": "date-time",
      "x-position": 1,
      "description": "Public sale's end dates. The date and time when the public sale will end"
    },
    "startDateTime": {
      "type": "string",
      "format": "date-time",
      "description": "Public sale's start dates. The date and time when the public sale will start"
    }
  },
  "description": "Event's Public Onsales Dates"
}
object PublicVisibility 
{
  "type": "object",
  "description": "The class defines the public visibility period on the Discovery/Publish API."
}
object Relationship 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "x-position": 2,
      "description": "The ID of the related entity"
    },
    "type": {
      "enum": [
        "duplicate"
      ],
      "type": "string",
      "description": "The type of the relationship"
    },
    "source": {
      "type": "string",
      "x-position": 1,
      "description": "The source name of the related entity"
    },
    "references": {
      "type": "object",
      "example": "sourceName: id",
      "x-position": 3,
      "description": "References of this relationship in another system. Reference is the exact same entity",
      "additionalProperties": {
        "type": "string"
      }
    }
  },
  "description": "Relationship"
}
object SeatMap 
{
  "type": "object",
  "properties": {
    "staticUrl": {
      "type": "string",
      "x-position": 3,
      "description": "Static Seatmap Url"
    }
  },
  "description": "Seatmap"
}
object Segment 
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The ID of the classification's level"
    },
    "name": {
      "type": "string",
      "x-position": 1,
      "description": "The Name of the classification's level"
    }
  },
  "description": "Segment"
}
object Social 
{
  "type": "object",
  "properties": {
    "twitter": {
      "$ref": "#/components/schemas/Twitter"
    }
  },
  "description": "Social networks data"
}
object Source 
{
  "type": "object",
  "description": "Source"
}
object StartDates 
{
  "type": "object",
  "properties": {
    "dateTBA": {
      "type": "boolean",
      "default": false,
      "x-position": 4,
      "description": "Boolean flag to indicate whether or not the start date is TBA"
    },
    "dateTBD": {
      "type": "boolean",
      "default": false,
      "x-position": 3,
      "description": "Boolean flag to indicate whether or not the start date is TBD"
    },
    "timeTBA": {
      "type": "boolean",
      "default": false,
      "x-position": 5,
      "description": "Boolean flag to indicate whether or not the start time is TBA"
    },
    "dateTime": {
      "type": "string",
      "format": "date-time",
      "example": "yyyy-MM-ddThh:mm:ssZ",
      "x-position": 2,
      "description": "The event start datetime"
    },
    "localDate": {
      "type": "string",
      "format": "date",
      "example": "yyyy-MM-dd",
      "description": "The event start date in local date"
    },
    "localTime": {
      "$ref": "#/components/schemas/LocalTime"
    },
    "noSpecificTime": {
      "type": "boolean",
      "default": false,
      "x-position": 6,
      "description": "Boolean flag to indicate whether or not the event start time has no specific time"
    }
  },
  "description": "Event's Start Dates"
}
object State 
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    },
    "stateCode": {
      "type": "string",
      "description": "State code"
    }
  },
  "description": "State"
}
object TatExtension 
{
  "type": "object",
  "description": "The Attraction Tool (TAT) extension"
}
object TicketmasterAttractionExtensions 
{
  "type": "object",
  "description": "Attraction's extension (ticketmaster source)"
}
object TicketmasterEventExtensions 
{
  "type": "object",
  "properties": {
    "displaySettings": {
      "$ref": "#/components/schemas/DisplaySettingExtension"
    }
  },
  "description": "Event's extension (ticketmaster source)"
}
object TicketmasterVenueExtensions 
{
  "type": "object",
  "description": "Venue's extension (ticketmaster source)"
}
object Twitter 
{
  "type": "object",
  "properties": {
    "handle": {
      "enum": [
        "@a Twitter handle"
      ],
      "type": "string",
      "example": "@a Twitter handle exampe",
      "description": "Twitter handle"
    },
    "hashtags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "example": "#hashtag example #hashtag another example",
      "x-position": 1,
      "description": "Twitter hashtags"
    }
  },
  "description": "Twitter data"
}
array V2EventSearchResponse 
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/Event"
  }
}
string V2FindSuggest200Response 
{
  "type": "string"
}
string V2FindSuggestResponse 
{
  "type": "string"
}
array V2FindVenuesResponse 
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/Venue"
  }
}
array V2SearchAttractionsResponse 
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/Attraction"
  }
}
array V2SearchClassificationsResponse 
{
  "type": "array",
  "items": {
    "$ref": "#/components/schemas/Classification"
  }
}
object Venue 
{
  "type": "object",
  "required": [
    "id",
    "type"
  ],
  "properties": {
    "id": {
      "type": "string",
      "x-position": 1,
      "description": "Unique id of the entity in the discovery API"
    },
    "dma": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Dma"
      },
      "x-position": 29,
      "description": "The list of associated DMAs (Designated Market Areas) of the venue"
    },
    "url": {
      "type": "string",
      "x-position": 24,
      "description": "URL of a web site detail page of the entity"
    },
    "city": {
      "$ref": "#/components/schemas/City"
    },
    "name": {
      "type": "string",
      "x-position": 10,
      "description": "Name of the entity"
    },
    "test": {
      "type": "boolean",
      "default": false,
      "x-position": 96,
      "description": "Indicate if this is a test entity, by default test entities won't appear in discovery API"
    },
    "type": {
      "enum": [
        "event",
        "venue",
        "attraction"
      ],
      "type": "string",
      "description": "Type of the entity"
    },
    "state": {
      "$ref": "#/components/schemas/State"
    },
    "units": {
      "type": "string"
    },
    "images": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Image"
      },
      "x-position": 29,
      "description": "Images of the entity",
      "uniqueItems": true
    },
    "locale": {
      "type": "string",
      "x-position": 3,
      "description": "Locale in which the content is returned"
    },
    "social": {
      "$ref": "#/components/schemas/Social"
    },
    "address": {
      "$ref": "#/components/schemas/Address"
    },
    "country": {
      "$ref": "#/components/schemas/Country"
    },
    "markets": {
      "type": "array",
      "items": {
        "$ref": "#/components/schemas/Market"
      },
      "x-position": 28,
      "description": "Markets of the venue"
    },
    "currency": {
      "type": "string",
      "x-position": 27,
      "description": "Default currency of ticket prices for events in this venue"
    },
    "distance": {
      "type": "number",
      "format": "double"
    },
    "location": {
      "$ref": "#/components/schemas/Location"
    },
    "timezone": {
      "type": "string",
      "x-position": 26,
      "description": "Timezone of the venue"
    },
    "postalCode": {
      "type": "string",
      "x-position": 24,
      "description": "Postal code / zipcode of the venue"
    },
    "description": {
      "type": "string",
      "x-position": 20,
      "description": "Description's of the entity"
    },
    "generalInfo": {
      "$ref": "#/components/schemas/VenueGeneralInfo"
    },
    "boxOfficeInfo": {
      "$ref": "#/components/schemas/VenueBoxOfficeInfo"
    },
    "externalLinks": {
      "type": "object",
      "x-position": 79,
      "description": "List of external links",
      "additionalProperties": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/ExternalLink"
        }
      }
    },
    "parkingDetail": {
      "type": "string",
      "x-position": 33,
      "description": "Venue parking info"
    },
    "additionalInfo": {
      "type": "string",
      "x-position": 22,
      "description": "Additional information of the entity"
    },
    "upcomingEvents": {
      "type": "object",
      "x-position": 110,
      "description": "number of upcoming events",
      "additionalProperties": {
        "type": "integer",
        "format": "int32"
      }
    },
    "accessibleSeatingDetail": {
      "type": "string",
      "x-position": 35,
      "description": "Venue accessible seating detail"
    }
  },
  "description": "Venue"
}
object VenueBoxOfficeInfo 
{
  "type": "object",
  "properties": {
    "willCallDetail": {
      "type": "string",
      "x-position": 7,
      "description": "Venue box office will call details"
    },
    "openHoursDetail": {
      "type": "string",
      "x-position": 3,
      "description": "Venue box office opening hours"
    },
    "phoneNumberDetail": {
      "type": "string",
      "x-position": 1,
      "description": "Venue box office phone number"
    },
    "acceptedPaymentDetail": {
      "type": "string",
      "x-position": 5,
      "description": "Venue box office accepted payment details"
    }
  },
  "description": "Venue box office information"
}
object VenueExtensions 
{
  "type": "object",
  "properties": {
    "geolocation": {
      "$ref": "#/components/schemas/GeolocationVenueExtensions"
    }
  },
  "description": "All Venue's extensions"
}
object VenueGeneralInfo 
{
  "type": "object",
  "properties": {
    "childRule": {
      "type": "string",
      "x-position": 3,
      "description": "Venue children rule"
    },
    "generalRule": {
      "type": "string",
      "x-position": 1,
      "description": "Venue general rules"
    }
  },
  "description": "Venue general information"
}