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}®ion=UK
For UK IE events: Legacy ID https://app.ticketmaster.com/inventory-status/v1/availability/legacy?events={events}&apikey={apikey}®ion=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
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. |