The Ticketmaster Availability API lets clients find out the ticket and seat availability information.
Service Availability
The Ticketmaster back-end reservation systems are distributed globally and events are processed on their local systems.
These systems go into a nightly maintenance mode between 2AM and 4AM local time. This means a show playing at Madison Square Garden will not be transactable between 2AM-4AM Eastern Time. Use the timezone value from the event details response to note when these events may be unavailable for transactions.
Quota Policy
A quota policy is applied for all the request made to endpoint(s)
/events/{eventId}/availability
The following headers are returned in the response add more information about the quota
Ratelimit-Quota-Allowed : Returns the allowed quota count
Ratelimit-Quota-Used : Returns the current quota used within a quota interval
Ratelimit-Expiry : Returns the UTC time in milliseconds which determines when the quota expires and new quota interval starts.
Ratelimit-Quota-Available : The no of requests (remaining) that can be made within the time limit
The restriction is 3600 requests/hour for an apikey.If you get a 429 error code, it means that your request was aborted because of violation of quota policy.
Get Event ID [GET]
Returns an alphanumeric event id based on a Venue-supplied event code+host combination
For use by Channel Partners only. Discover events available to transact on. For specifically-enabled accounts only.
Note:
This endpoint supports paging. The current paging limit is 10K events per page.
/partners/v1/events
Query Parameters
Parameter
Description
Type
Example
Required
source
Filter events by brand, Ticketmaster or Universe. Use source to access Ticketmaster events by country (see Event Source by Country).
string
TM_US, TM_UK, MFX, Universe
No (default=TM_US)
market
Returns the events for a specific market when source = MFX. Comma-separated list is not supported.
string
ES
Yes, if source=MFX; No, if source = TM_US, TM_UK or Universe
limit
limits the number of results per page
number
1000
No (default is 10000 results per page)
page
indicates page of results to return
number
1
No (default=1)
venueId
filter by venue id when source=TM_US or source=TM_UK (can be legacy or universal ID)
string
“106601” or “KovZpZAJtFaA”
No
attractionId
filter by attraction id when source=TM_US or source=TM_UK
string
“K8vZ917QcY7”
No
startDateTime
filter with eventDateTime after this date when source=TM_US or source=TM_UK
string format “yyyy-MM-dd HH:mm:ss.S”
“2023-01-01 00:00:00.0”
No
endDateTime
filter with eventDateTime before this date when source=TM_US or source=TM_UK
string format “yyyy-MM-dd HH:mm:ss.S”
“2023-05-02 15:48:00.0”
No
includeTest
no, if you want to exclude test events from the response. only, if you want to return only test events
string enum: [“yes”, “no”, “only”]
“no”
No (default=”yes”)
events
filter by comma separated list of universal or legacy event IDs. Maximum of 100 event IDs
string
“vvG1YZaz90eQOc,1D005F26CC394D80”
No
Event Source by Country
The Partner API provides access to events published from various sources and countries. To specify a specific brand, use the &source= parameter. For Ticketmaster events, use the &source= parameter to access events in the countries shown in the table below. If the source=MFX, you must also specify the country with the &market= parameter.
Brand
Source
Supported Countries
Ticketmaster
TM_US
US, CA, AU, NZ
Ticketmaster
TM_UK
UK, IE
Ticketmaster
MFX
ES
Universe
Universe
US
Polling: No
Response structure:
events (array) - Events.
{arrayitemobject} - event
eventCode (string) - Event code Eg: “EPT0726E”
eventHost (string) - Host system Eg: “LA2”
attractions (array) - Attractions on the Event
{arrayitemobject} - attraction
id (string) - Attraction Id eg: “K8vZ917QcY7”
offers (array) - Offers on the Event
{arrayitemobject} - offer
repName (text) - Offer name. Eg: “GPAS4”
ticketType (text) - Ticket Type Id Eg: “00004C440003”
enabled(boolean) - when true the offer is enabled.
eventId (string) - Event ID Eg. “0B004D43F86C478F”
universalId (string) - Event ID Eg. “vvG1VZggguJvr”
eventDate (date) - Event Date is Local Date YYYY-MM-DD format
eventTime (time) - Event Time is Local Time HH:MM:SS format
timeZone (text) - Time zone of the event venue location Eg: “America/Los_Angeles”
onsale (string) - the complete date time for the event onsale in UTC.
offsale (string) - the complete date time for the event offsale in UTC.
seatLocationMapRestrict(boolean) - when true, host’s ascii map through the sell prompt in tmwin will not be displayed.
locRowSeatRestrict(boolean) - when true, requires any client/partner to hide row and seat names from the customer.
locXnumAddescRestrict(boolean) - when true, Xnumbers, ADDDESC, section on the event will not be displayed.
eventDateTime(string) - the complete date time for the event.
restrictSingle(boolean) - when true, a single seat shoudl not be left behind when creating a cart.
safeTixEnabled(boolean) - when true, the event is enabled for safetix tickets for entry.
description(string) - the description of the offers.
enabled(boolean) - when true, the event is enabled.
repName(string) - the repname associated with the offer.
extTicketType(string) - the ticket type id associated with the offer.
venueId(string) - ID of the venue.
universalVenueId(string) - Universal ID of the venue.
isCancelled(boolean) - when true, the event is canceled.
testEvent(boolean) - when true, the event is not a live event. It is set up for testing.
isPostponed(boolean) - when true, the event is postponed.
isRescheduled(boolean) - when true, the event is rescheduled.
seatLocationMapRestrict(boolean) - when true, Xnumbers, ADDDESC, section on the event will not be displayed.
isGranularPricingEnabled(boolean) - when true, granular pricing is enabled.
allInclusivePricing(boolean) - when true the event is using all-in pricing. Field is not present in Universe or MFX responses.
locXnumAddescRestrict(boolean)
locRowSeatRestrict(boolean)
serviceFeeRollup(boolean) - when true the service fee is rolled up in the face value.
facilityFeeRollup(boolean) - when true the facility fee is rolled up in the face value.
eventSource(string) - name of the event source Eg. TM_US, MFX, Universe
For use by Channel Partners only. Get total allocated and remaining ticket amounts for each ticket type per event. Current un-sold seat inventory is also included along with the current ticket reservation limit.
This service should not be used in real-time in line with an active purchase being made. The data available by this service may be cached for extended periods of time. Usage should be in accordance with agreed-upon rate limits between TM and the Channel Partner. Contact Ticketmaster for enablement.
For inventory that has been exclusively set aside, Channel partners are expected to maintain their own inventory counts and should only periodically check this service to sync inventory with their internal systems. However, for inventory that is “open” (non-exclusive) where anyone can sell from, Channel partners should not maintain their own inventory counts.
Note:
To get the list price of the tickets please add the query parameter getBasePrice=true when making Availability calls.
priceLevelId is not a static Value. Partners should not rely on priceLevelId in order to identify a specific offer with a specific price
restrictedPayment flag indicates that the offer has restricted payment options e.g. Amex ,Citi cards etc.
/partners/v1/events/{event_id}/availability
Polling: No
Parameters
Parameter
Description
Type
Example
Required
event_id
The 16-digit alphanumeric event ID.
string
“0B004D43F86C478F”
Yes
Response structure:
event (object) - Event.
id (string) - Event ID
restrictSingle (boolean) - true/false. Indicates a reserve cannot leave 1 seat remaining among a contiguous set of seats
safeTixEnabled (boolean) - true/false. Indicates if an event is Safetix enabled/enforced.
eventTicketLimit (number) - 0 means unlimited, but reserves may still be limited by current seat inventory (currentTicketLimit)
onsale (datetime) - Event onsale date and time in UTC format
offsale (datetime) - Event off sale date and time in UTC format
eventDateTime (datetime) - Event Date & Time in UTC format
seatLocationMapRestrict (boolean) - when true, host’s ascii map through the sell prompt in tmwin will not be displayed.
locRowSeatRestrict (boolean) - when true, requires any client/partner to hide row and seat names from the customer.
locXnumAddescRestrict (boolean) - when true, Xnumbers, ADDDESC, section on the event will not be displayed.
serviceFeeRollup (boolean) - when true, service fee is rolled up in the face value
facilityFeeRollup (boolean) - when true, facility fee is rolled up in the face value
granularPricing (boolean) - when true, the event is using granular pricing.
allInclusivePricing (boolean) - when true, the event is using all-in pricing. Field is not present in Universe or MFX responses.
tickets (array) - tickets
{arrayitemobject} - ticket
offers (array) - Offers
{arrayitemobject} - offer
ticketTypeId (text) - Ticket Type Id
priceLevelId (number) - Price Level Id // It is not a static value. Partners should not rely on priceLevelId in order to identify a specific offer with a specific price
currency (text) - currency
faceValue (number) - Face Value of the ticket
totalPrice (number) - Total Price of ticket when purchased on Ticketmaster (returned in response when getBasePrice=true parameter is used)
listPrice (number) - Price of the ticket listed on Ticketmaster (returned in response when getBasePrice=true parameter is used)
charges (array) - Charges
{arrayitemobject} - charge
reason (text) - Charge reason. Eg. ‘facility’
type (text) - type of charge. Eg. ‘fee’
amount (number) - charge amount in the currency
offerName (text) - Name of the offer
offerDescription (text) - Description of the offer
eventTicketMinimum(number) - Minimum no of tickets that can be purchased
restrictedPayment (boolean) - when true, it indicates that the offer has restricted payment options e.g. Amex ,Citi cards etc.
sellableQuantities (array) - No of seats that can be sold together
available (number) - number of seats available
total (number) - total number of seats
seating (number) - type of seat “reserved” or “general”
inventory (array) - Inventory
{arrayitemobject} - Inventory item
section (text) - Section prefix
row (text) - Row name
seats (array) - seats
{arrayitemobject} - seat number
places (array) - places
{arrayitemobject} - place
hasEvenOddMix (boolean) - true/false. ‘false’ if row has only even or only odd numbered seating.
eventTicketLimit (number) - Ticket Limit for this offer.
currentTicketLimit (number) - Capped by available inventory and eventTicketLimit.
Pod Seating is a seating arrangement that allows an event to operate at reduced capacity so family and friends can maintain a socially safe distance from other attendees. Pod Seating enables venues to sell seats together as a group or ‘pod’ (e.g., pod of 4 seats), and each pod is spaced apart from other pods based on local health and safety guidelines. To maintain pod integrity, ticket buyers are required to purchase the entire pod and may not split the pod, ensuring that people who chose to attend an event together will not sit next to other people who are unknown to them. A variety of venues have adopted Pod Seating, including concerts, comedy shows and sports leagues.
Availability API Response
The Availability API has been updated to show the sellable ticket quantities (displayed as “sellableQuantities”) for each offer, which provides the number of tickets that fans can purchase in a single transaction. Fans may only buy tickets in a quantity shown under sellableQuantities. If fans attempt to purchase tickets in any other amount, the Reserve response will return a 400 error with the message “Inventory authorization failure due to limit violation” . The Availability API will return sellableQuantities for all events, including events that have not implemented Pod Seating.