Availability API

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

/partners/v1/events/{event_code}/{event_host}/id

Polling: No

Parameters

Parameter Description Type Example Required
event_code The event code given by the venue. string “53-45243” Yes
event_host The event host given by the venue. string “NY1” Yes

Request Response

https://app.ticketmaster.com/partners/v1/events/53-45243/NY1/id?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne
Status 200
{
    "event" : {
        "id" : "0B004D43F86C478F"

    }
}

Event Inventory [GET]

For use by Channel Partners only. Discover events available to transact on. For specifically-enabled accounts only.

/partners/v1/events

Query Parameters

Parameter Description Type Example Required
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)

Polling: No

Response structure:

  • events (array) - Events.
    • {arrayitemobject} - event
      • eventCode (string) - Event code Eg: “EPT0726E”
      • eventHost (string) - Host system Eg: “LA2”
      • eventId (string) - Event ID Eg. “0B004D43F86C478F”
      • 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”
      • 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.
      • offers (array) - Offers on the Event
        • {arrayitemobject} - offer
          • repName (text) - Offer name. Eg: “GPAS4”
          • ticketType (text) - Ticket Type Id Eg: “00004C440003”

Request Response

https://app.ticketmaster.com/partners/v1/events?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne&limit=2000&page=2
Status 200
{
    "page": 2,
    "results": 826,
    "totalPages": 2,
    "totalResults": 10826,
    "events" : [
        {
            "eventCode" : "EPT0726E",
            "eventHost" : "LA2",
            "eventId" : "0B004D43F86C478F",
            "eventDate" : "2015-07-26",
            "eventTime" : "18:30:00",
            "timeZone" : "America/Los_Angeles",
            "seatLocationMapRestrict": false,
            "locXnumAddescRestrict": false,
            "locRowSeatRestrict": false,
            "offers": [
                { "repName": "GPAS4", "ticketType": "00004C440003" }
            ]
        },
        {
            "eventCode" : "EPT0896A",
            "eventHost" : "LA2",
            "eventId" : "0C004F43F86C4BAC",
            "eventDate" : "2015-07-27",
            "eventTime" : "18:30:00",
            "timeZone" : "America/Los_Angeles",
            "offers": [
                { "repName": "GPAS4", "ticketType": "00004C440004" }
            ]
        }

        // ...

    ]
}

Ticket Inventory and Seat Availability [GET]

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.

Note: priceLevelId is not a static Value. Partners should not rely on priceLevelId in order to identify a specific offer with a specific price

/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.
    • 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
            • 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
        • 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.

Request Response

https://app.ticketmaster.com/partners/v1/events/0B004D43F86C478F/availability?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne
Status 200
{
    "event" : {
        "id":"0B004D43F86C478F",
        "restrictSingle" : true,  // indicates a reserve cannot leave 1 seat remaining among a contiguous set of seats

        "safeTixEnabled": false,
        "eventTicketLimit" : 10,  // 0 = unlimited for this event, but reserves may still be limited by current seat inventory (currentTicketLimit) 

        "seatLocationMapRestrict": false,
        "locXnumAddescRestrict": false,
        "locRowSeatRestrict": false,
        "serviceFeeRollup": false,
        "facilityFeeRollup": true,
        "granularPricing": false,
        "tickets":[
            {

                "available":5034,
                "total": 10345,
                "currentTicketLimit" : 4, // capped by available inventory and eventTicketLimit

                "inventory" : [
                    // hasEvenOddMix indicates the row has even/odd numbered seating.

                    { "section" : "207", "row" : "A", "seats" : [ 2, 4, 6, 8], "places" : ["INGEEMRQHE5E2ORRG4", "INGEEMRQHE5E2ORRGA", "INGEEMRQHE5E2ORRGE", "INGEEMRQHE5E2ORRGI"], "hasEvenOddMix" : false},      

                    { "section" : "208", "row" : "A", "seats" : [ 1, 2], "places" : ["INGEEMRQHE5E2ORU", "INGEEMRQHE5E2ORV"], "hasEvenOddMix" : true}
                ],

                "offers" : [
                    {
                        "charges" : [
                            {
                                "amount" : 3.0,
                                "reason" : "facility",
                                "type": "fee"
                            }
                        ],

                        "currency": "USD",
                        "faceValue" : 25.0,
                        "offerDescription" : "GPAS1",
                        "offerName" : "GPAS1",
                        "eventTicketMinimum": 1,
                        "priceLevelId" : "1", //priceLevelId is not a static Value. Partners should not rely on priceLevelId in order  to identify a specific offer with a specific price  


                        "ticketTypeId" : "00000405000C"
                    },
                    {
                        "charges" : [
                            {
                                "amount" : 3.0,
                                "reason" : "facility",
                                "type": "fee"
                            }
                        ],

                        "currency": "USD",
                        "faceValue" : 25.0,
                        "offerDescription" : "GPAS1J",
                        "offerName" : "GPAS1J",
                        "eventTicketMinimum": 1,
                        "priceLevelId" : "1",
                        "ticketTypeId" : "00000406000C"
                    }
                ]
            },

            {
                "available":43,
                "total": 108,
                "currentTicketLimit" : 6,
                "eventTicketLimit" : 10,
                "inventory" : [
                    { "section" : "209", "row" : "B", "seats" : [ 2, 4, 6, 8, 10, 12, 16],
                      "areas": [
		              {
		                "description": "Right Side of Theatre",
		                "name": "RIGHT",
		                "areaId": "10"
		              },
		              {
		                "description": "Main Floor-Orchestra Level",
		                "name": "ORCH",
		                "areaId": "5"
		              }
			         ],
                    "hasEvenOddMix" : false}
                ],
                "offers" : [
                    {
                        "charges" : [
                            {
                                "amount" : 5.0,
                                "reason" : "facility",
                                "type": "fee"
                            }
                        ],

                        "currency": "USD",
                        "faceValue" : 50.0,
                        "offerDescription" : "GPAS2",
                        "eventTicketMinimum": 1,
                        "offerName" : "GPAS2",
                        "priceLevelId" : "1",
                        "ticketTypeId" : "00000407000C"
                    }
                ]
            }
        ]
    }
}

Section Map Image [GET]

Returns a visual representation of the approximate location of the seats in the venue

/maps/geometry/3/event/{event_id}/image?systemId=HOST&apikey={apikey}

Polling: No

URL Parameters

Parameter Description Type Example Required
event_id The 16-digit alphanumeric event ID. string “0B004D43F86C478F” Yes

Query Parameters

Parameter Description Type Example Required
apikey Your API key string “GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne” Yes
w The width of the image in pixels (min: 102, max: 1024) number 300 No (default = 1024)
pw The width of the drop pin in pixels (min: 16, max: 64) number 30 No (default = 16)
sectionNames The section to highlight string “SEC101” No
placeId The place (section, row and seat) to drop the pin placement.PlaceIds are returned in the Availability API response. string “KNCUGQR2KQ5DC” No
showLabels Toggle showing labels on sections string “true” No (default=false)

Response

Status Code Note
200 Ok - Image Rendered
204 No content - Image not available. Event may not be configured with a seat map

Section map with highlight

Sample request with sectionNames=SECB

https://app.ticketmaster.com/maps/geometry/3/event/05005568DCC250FD/image?systemId=HOST&sectionNames=SECB&apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

Response:

drawing

Section map with highlight and pin placement

Sample request with sectionNames=SECB and placeId=KNCUGQR2KQ5DC

https://app.ticketmaster.com/maps/geometry/3/event/05005568DCC250FD/image?systemId=HOST&sectionNames=SECB&placeId=KNCUGQR2KQ5DC&apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

Response:

drawing

Section map with labels, highlight with pin placement

Sample request with showLabels=true, sectionNames=SECB and placeId=KNCUGQR2KQ5DC

https://app.ticketmaster.com/maps/geometry/3/event/05005568DCC250FD/image?systemId=HOST&sectionNames=SECB&placeId=KNCUGQR2KQ5DC&showLabels=true&apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

Response:

drawing