Inventory Status API

The Inventory Status API provides event status for primary Ticketmaster inventory with inventory updates happening near real-time.

Overview

Authentication

Access is provided to authorized clients only. Please request access by contacting devportalinquiry@ticketmaster.com.

Clients will be provided an API key from Ticketmaster which should be added to every resource endpoint call.

Example: https://app.ticketmaster.com/inventory-status/v1/availability?events=17AOv8G6G5rI0S0,1ApZA7pGkdEYAsy&apikey=avJHatT0NbQMlMQTDn6QFYoBrixJCp

Host and API endpoint information

https://app.ticketmaster.com/inventory-status/

All connections must be made over SSL using https.

Terms and Conditions

By using the Ticketmaster Developer Portal, you understand and agree to our Terms of Use.

Contact

Ticketmaster Developer Program devportalinquiry@ticketmaster.com.

Inventory Status Details [POST]

Retrieve availability status for comma separated list of universal event IDs.

/inventory-status/v1/availability?events={universalids}&apikey={apikey}

At this moment, this API does not support the following markets and will return a status of UKNOWN.

  • Primary Inventory: FR, IT, TR
  • Resale Inventory: FR, IT, TR

NOTE: for UK and IE events, the api requires the ‘region’ param like the example below…

For UK IE events: Universal ID https://app.ticketmaster.com/inventory-status/v1/availability?events={events}&apikey={apikey}&region=UK

For UK IE events: Legacy ID https://app.ticketmaster.com/inventory-status/v1/availability/legacy?events={events}&apikey={apikey}&region=UK

Min/Max Price Ranges

When you query for an event, the API will return the minimum and maximum prices on available inventory at the time of request.

This Price Ranges feature is currently only supported in these markets: US, CA, UK, IE, AU, NZ, MX. If the API does not have price data available, it will not return a minimum or maximum price in the response structure. If the maximum price ticket on an event is more than 2000.00, the API will return 2000.00 as the max price and the field listingsExtendBeyondMax will be set to true. Otherwise, the max price ticket value will be returned and that boolean will be set to false.

The minimum and maximum prices returned are currently the face value of the ticket only, the price does not include fees.

Prices are refreshed at a maximum frequency of once per hour.

Query Parameters

Parameter Description Type Example Required
events Comma separated list of universal event IDs. Maximum of 1000 universal event IDs. string 17AOv8G6G5rI0S0,1ApZA7pGkdEYAsy Yes
apikey Your API Key string GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne Yes

Response structure:

Array of json objects with attributes “eventid” & “status“

  • eventid
  • status
  • currency(string) - ISO 4217 currency code; local currency for the event
  • priceRanges
    • type(string) - the inventory type for the price range (e.g. Primary, Resale)
    • minPrice(string) - lowest price ticket available - face value of the ticket not inclusive of fees
    • maxPrice(string) - maximum price ticket available - face value of the ticket not inclusive of fees
    • listingsExtendBeyondMax(boolean) - True/False depending on if the maxPrice is above or below 2000.00 local currency

Request Response

https://app.ticketmaster.com/inventory-status/v1/availability?events=17AOv8G6G5rI0S0,1ApZA7pGkdEYAsy&apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne
Status 200
[
    {
        "eventId": "17AOv8G6G5rI0S0",
        "status": "TICKETS_NOT_AVAILABLE",
        "resaleStatus": "TICKETS_AVAILABLE",
        "currency": "USD",
                "priceRanges": [
                    {
                        "type": "primary",
                        "minPrice": 59.00,
                        "maxPrice": 249.00,
                        "listingsExtendBeyondMax": false
                    },
                    {
                        "type": "resale",
                        "minPrice": 69.00,
                        "maxPrice": 2000.00,
                        "listingsExtendBeyondMax": false
                    }
        ]
    },
    {
        "eventId": "1ApZA7pGkdEYAsy",
        "status": "TICKETS_AVAILABLE",
        "resaleStatus": "TICKETS_NOT_AVAILABLE",
        "currency": "USD",
                "priceRanges": [
                    {
                        "type": "primary",
                        "minPrice": 69.50,
                        "maxPrice": 600.00,
                        "listingsExtendBeyondMax": false
                    },
                    {
                        "type": "resale",
                        "minPrice": 68.00,
                        "maxPrice": 2000.00,
                        "listingsExtendBeyondMax": true
                    }
                ]
    }
]

Responses

Primary Inventory Responses

Response Description
TICKETS_AVAILABLE Indicates inventory is available for purchase through primary channels.
FEW_TICKETS_LEFT Indicates inventory is limited.
TICKETS_NOT_AVAILABLE Indicates inventory is not available for purchase through primary channels.
UNKNOWN Indicates the event id is invalid or the inventory status is not available for the corresponding event at this time.

Resale Inventory Responses

Response Description
TICKETS_AVAILABLE Indicates inventory is available for purchase through primary channels.
TICKETS_NOT_AVAILABLE Indicates inventory is not available for purchase through primary channels.
UNKNOWN Indicates the event id is invalid or the inventory status is not available for the corresponding event at this time.