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}

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

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

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"
    },
    {
        "eventId": "1ApZA7pGkdEYAsy",
        "status": "TICKETS_AVAILABLE",
        "resaleStatus": "TICKETS_NOT_AVAILABLE"
    }
]

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.