Ticketmaster

Event and ticket discovery API

developer.ticketmaster.com ↗
Version
v2
OpenAPI
3.0.0
Endpoints
13
Schemas
71
91
Quality
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

Endpoints

Clear filters

No endpoints found for this provider.

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