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.

Note:

  1. 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

Response Sample for Host events

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": [
    {
    "eventId": "0D005AFC9636605E",
    "universalId": "vvG1VZpRwpuJvr",
    "attractions": [
      {
         "id": "K8vZ917QcY7"
      },
      {
         "id": "K8vZ917bPjV"
      }
    ],
    "offers": [
    {
    "repName": "GPAS2",
    "ticketType": "010000020003",
    "enabled": true
    }
    ],
    "eventCode": "EAA0901",
    "eventHost": "FLO",
    "eventDate": "2021-09-01",
    "eventTime": "19:00:00",
    "timeZone": "America/New_York",
    "eventDateTime": "2021-09-01 23:00:00.0",
    "restrictSingle": "N",
    "safeTixEnabled": true,
    "description": "GPAS2@GRPN.",
    "enabled": "Y",
    "repName": "GPAS2",
    "extTicketType": "010000020003",
    "venueId": "106601",
    "isCancelled": false,
    "testEvent": false,
    "isPostponed": false,
    "isRescheduled": false,
    "isGranularPricingEnabled": false,
    "allInclusivePricing": false,
    "seatLocationMapRestrict": false,
    "locXnumAddescRestrict": false,
    "locRowSeatRestrict": false,
    "serviceFeeRollup": false,
    "facilityFeeRollup": false,
    "eventSource": "TM_US"
    },
    {
    "eventId": "0D005A79DC204B8E",
    "universalId": "vvG1VZpEEjF7mC",
    "offers": [
    {
    "repName": "GPAS1",
    "ticketType": "000058080003",
    "enabled": true
    }
    ],
    "eventCode": "ETD1227",
    "eventHost": "FLO",
    "eventDate": "2021-12-27",
    "eventTime": "20:00:00",
    "timeZone": "America/New_York",
    "onsale": "2021-03-24 19:14:16.0",
    "offsale": "2021-12-27 21:00:00.0",
    "eventDateTime": "2021-12-28 01:00:00.0",
    "restrictSingle": "N",
    "safeTixEnabled": false,
    "eventSource": "TM_US"

        // ...

    ]
}

Response Sample for MFX events

  • Please note: Attractions are not available for MFX events response

Request Response

https://app.ticketmaster.com/partners/v1/events?source=mfx&apikey=63rJbbsssjdhkwehdD7b4s&market=es
Status 200
{
   "page":1,
   "results":7,
   "totalPages":1,
   "totalResults":7,
   "events":[
      {
         "eventId":"35101",
         "universalId":"Z698xZ2qZaF0q",
         "offers":[
            {
               "repName":"REG.",
               "ticketType":"1",
               "enabled":true
            },
            {
               "repName":"REG.",
               "ticketType":"1",
               "enabled":true
            },
            {
               "repName":"STU",
               "ticketType":"2",
               "enabled":true
            },
            {
               "repName":"STU",
               "ticketType":"2",
               "enabled":true
            },
            {
               "repName":"COMP",
               "ticketType":"3",
               "enabled":true
            },
            {
               "repName":"COMP",
               "ticketType":"3",
               "enabled":true
            }
         ],
         "eventCode":"TSTINGRA-2023",
         "eventHost":"ES",
         "eventDate":"2023-07-01",
         "eventTime":"20:00",
         "timeZone":"Europe/Madrid",
         "offsale":"2023-07-01 23:59",
         "onsale":"2023-03-09 11:15",
         "eventDateTime":"2023-07-01 20:00",
         "restrictSingle":"N",
         "safeTixEnabled":false,
         "description":"Test event for Microflex Partner API INGRESSO",
         "enabled":"Y",
         "repName":"",
         "extTicketType":"",
         "venueId":"1651",
         "isCancelled":false,
         "testEvent":false,
         "isPostponed":false,
         "isRescheduled":false,
         "isGranularPricingEnabled":false,
         "seatLocationMapRestrict":false,
         "locXnumAddescRestrict":false,
         "locRowSeatRestrict":false,
         "serviceFeeRollup":false,
         "facilityFeeRollup":false,
         "eventSource":"MFX"
      },
      {
         "eventId":"35099",
         "universalId":"Z698xZ2qZaF0h",
         "offers":[
            {
               "repName":"REG.",
               "ticketType":"1",
               "enabled":true
            },
            {
               "repName":"REG.",
               "ticketType":"1",
               "enabled":true
            },
            {
               "repName":"STU",
               "ticketType":"2",
               "enabled":true
            },
            {
               "repName":"STU",
               "ticketType":"2",
               "enabled":true
            },
            {
               "repName":"COMP",
               "ticketType":"3",
               "enabled":true
            },
            {
               "repName":"COMP",
               "ticketType":"3",
               "enabled":true
            }
         ],
         "eventCode":"TSTINGR9-2023",
         "eventHost":"ES",
         "eventDate":"2023-07-01",
         "eventTime":"20:00",
         "timeZone":"Europe/Madrid",
         "offsale":"2023-07-01 23:59",
         "onsale":"2023-03-09 11:07",
         "eventDateTime":"2023-07-01 20:00",
         "restrictSingle":"N",
         "safeTixEnabled":false,
         "description":"Test event for Microflex Partner API INGRESSO",
         "enabled":"Y",
         "repName":"",
         "extTicketType":"",
         "venueId":"1651",
         "isCancelled":false,
         "testEvent":false,
         "isPostponed":false,
         "isRescheduled":false,
         "isGranularPricingEnabled":false,
         "seatLocationMapRestrict":false,
         "locXnumAddescRestrict":false,
         "locRowSeatRestrict":false,
         "serviceFeeRollup":false,
         "facilityFeeRollup":false,
         "eventSource":"MFX"
      }
      //...

   ]
}

Response Sample for Universe events

  • Please note: Attractions are not available for Universe events response

Request Response

https://app.ticketmaster.com/partners/v1/events?apikey=63rJbFA5hEvdagwfdhajhwdvhoD7b4s&source=universe
Status 200
{
   "page":1,
   "results":7,
   "totalPages":1,
   "totalResults":7,
   "events":[
      {
         "eventId":"35101",
         "universalId":"Z698xZ2qZaF0q",
         "offers":[
            {
               "repName":"REG.",
               "ticketType":"1",
               "enabled":true
            },
            {
               "repName":"REG.",
               "ticketType":"1",
               "enabled":true
            },
            {
               "repName":"STU",
               "ticketType":"2",
               "enabled":true
            },
            {
               "repName":"STU",
               "ticketType":"2",
               "enabled":true
            },
            {
               "repName":"COMP",
               "ticketType":"3",
               "enabled":true
            },
            {
               "repName":"COMP",
               "ticketType":"3",
               "enabled":true
            }
         ],
         "eventCode":"TSTINGRA-2023",
         "eventHost":"ES",
         "eventDate":"2023-07-01",
         "eventTime":"20:00",
         "timeZone":"Europe/Madrid",
         "offsale":"2023-07-01 23:59",
         "onsale":"2023-03-09 11:15",
         "eventDateTime":"2023-07-01 20:00",
         "restrictSingle":"N",
         "safeTixEnabled":false,
         "description":"Test event for Microflex Partner API INGRESSO",
         "enabled":"Y",
         "repName":"",
         "extTicketType":"",
         "venueId":"1651",
         "isCancelled":false,
         "testEvent":false,
         "isPostponed":false,
         "isRescheduled":false,
         "isGranularPricingEnabled":false,
         "seatLocationMapRestrict":false,
         "locXnumAddescRestrict":false,
         "locRowSeatRestrict":false,
         "serviceFeeRollup":false,
         "facilityFeeRollup":false,
         "eventSource":"MFX"
      },
      {
         "eventId":"35099",
         "universalId":"Z698xZ2qZaF0h",
         "offers":[
            {
               "repName":"REG.",
               "ticketType":"1",
               "enabled":true
            },
            {
               "repName":"REG.",
               "ticketType":"1",
               "enabled":true
            },
            {
               "repName":"STU",
               "ticketType":"2",
               "enabled":true
            },
            {
               "repName":"STU",
               "ticketType":"2",
               "enabled":true
            },
            {
               "repName":"COMP",
               "ticketType":"3",
               "enabled":true
            },
            {
               "repName":"COMP",
               "ticketType":"3",
               "enabled":true
            }
         ],
         "eventCode":"TSTINGR9-2023",
         "eventHost":"ES",
         "eventDate":"2023-07-01",
         "eventTime":"20:00",
         "timeZone":"Europe/Madrid",
         "offsale":"2023-07-01 23:59",
         "onsale":"2023-03-09 11:07",
         "eventDateTime":"2023-07-01 20:00",
         "restrictSingle":"N",
         "safeTixEnabled":false,
         "description":"Test event for Microflex Partner API INGRESSO",
         "enabled":"Y",
         "repName":"",
         "extTicketType":"",
         "venueId":"1651",
         "isCancelled":false,
         "testEvent":false,
         "isPostponed":false,
         "isRescheduled":false,
         "isGranularPricingEnabled":false,
         "seatLocationMapRestrict":false,
         "locXnumAddescRestrict":false,
         "locRowSeatRestrict":false,
         "serviceFeeRollup":false,
         "facilityFeeRollup":false,
         "eventSource":"MFX"
      }
      //....

   ]
}

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:

  1. To get the list price of the tickets please add the query parameter getBasePrice=true when making Availability calls.
  2. priceLevelId is not a static Value. Partners should not rely on priceLevelId in order to identify a specific offer with a specific price
  3. 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.

Response without parameter getBasePrice

Request Response

https://app.ticketmaster.com/partners/v1/events/0B004D43F86C478F/availability?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne
Status 200
{
  "event": {
    "id": "0B004D43F86C478F",
    "restrictSingle": false,
    "safeTixEnabled": false,
    "eventTicketLimit": 0,
    "onsale": "2016-04-29 17:00:00.0",
    "offsale": "2022-08-20 17:00:00.0",
    "eventDateTime": "2021-11-26 03:00:00.0",
    "granularPricing": false,
    "allInclusivePricing": false,
    "tickets": [
      {
        "offers": [
          {
            "ticketTypeId": "000000000001",
            "priceLevelId": "9",
            "currency": "USD",
            "faceValue": 50.5,
            "charges": [
              {
                "reason": "facility",
                "type": "fee",
                "amount": 8
              },
              {
                "reason": "order_processing",
                "type": "fee",
                "amount": 0
              },
              {
                "reason": "service",
                "type": "fee",
                "amount": 15.8
              },
             {
                "reason": "service_tax",
                "type": "tax",
                "amount": 2
             },
             {
                "reason": "face_value_tax",
                "type": "tax",
                "amount": 3
              },
              {
              "reason": "service_tax_2",
              "type": "tax",
              "amount": 0.33
              }
            ],
            "offerName": "GPAS1",
            "offerDescription": "GPAS1",
            "eventTicketMinimum": 1,
            "restrictedPayment": false,
            "sellableQuantities": [
              1,
              2,
              3,
              4,
              5,
              6,
              7,
              8,
              9,
              10,
              11,
              12,
              13,
              14,
              15,
              16,
              17,
              18,
              19,
              20,
              21,
              22,
              23,
              24,
              25,
              26,
              27,
              28,
              29,
              30,
              31,
              32,
              33,
              34,
              35,
              36,
              37,
              38,
              39,
              40,
              41,
              42,
              43,
              44,
              45,
              46,
              47,
              48,
              49,
              50
            ],
            "protected": false
          }
        ],
        "available": 536,
        "total": 1009,
        "seating": "reserved",
        "currentTicketLimit": 20,
        "inventory": [
          {
            "section": "328",
            "row": "11",
            "seats": [
              15,
              16,
              17,
              18
            ],
            "places": [
              "GMZDQORRGE5DCNI",
              "GMZDQORRGE5DCNQ",
              "GMZDQORRGE5DCNY",
              "GMZDQORRGE5DCOA"
            ],
            "areas": [
              {
                "description": "Concourse 3",
                "name": "CON3",
                "areaId": "2",
                "areaLabel": "zone"
              }
            ],
            "attributes": [],
            "hasEvenOddMix": true
          },
          {
            "section": "328",
            "row": "12",
            "seats": [
              1,
              2,
              3,
              4,
              5,
              6,
              7,
              8,
              9,
              10,
              11,
              12,
              13,
              14,
              15,
              16
            ],
            "places": [
              "GMZDQORRGI5DC",
              "GMZDQORRGI5DE",
              "GMZDQORRGI5DG",
              "GMZDQORRGI5DI",
              "GMZDQORRGI5DK",
              "GMZDQORRGI5DM",
              "GMZDQORRGI5DO",
              "GMZDQORRGI5DQ",
              "GMZDQORRGI5DS",
              "GMZDQORRGI5DCMA",
              "GMZDQORRGI5DCMI",
              "GMZDQORRGI5DCMQ",
              "GMZDQORRGI5DCMY",
              "GMZDQORRGI5DCNA",
              "GMZDQORRGI5DCNI",
              "GMZDQORRGI5DCNQ"
            ],
            "areas": [
              {
                "description": "Concourse 3",
                "name": "CON3",
                "areaId": "2",
                "areaLabel": "zone"
              }
            ],
            "attributes": [],
            "hasEvenOddMix": true
          }
          //

        ],
        "eventTicketLimit": 0
      },
      {
        "offers": [
          {
            "ticketTypeId": "000000000001",
            "priceLevelId": "8",
            "currency": "USD",
            "faceValue": 64.5,
            "charges": [
              {
                "reason": "facility",
                "type": "fee",
                "amount": 8
              },
              {
                "reason": "service",
                "type": "fee",
                "amount": 6.75
              },
              {
                "reason": "order_processing",
                "type": "fee",
                "amount": 0
              },
              {
                 "reason": "service_tax",
                 "type": "tax",
                 "amount": 2
              },
              {
                 "reason": "face_value_tax",
                 "type": "tax",
                 "amount": 3
              },
              {
                   "reason": "service_tax_2",
                   "type": "tax",
                   "amount": 2
              }
            ],
            "offerName": "Standard Ticket",
            "offerDescription": "Standard Ticket",
            "eventTicketMinimum": 1,
            "restrictedPayment": false,
            "sellableQuantities": [
              1,
              2,
              3,
              4,
              5,
              6,
              7,
              8,
              9,
              10
            ],
            "protected": false
          }
        ],
        "available": 1518,
        "total": 2429,
        "seating": "reserved",
        "currentTicketLimit": 27,
        "inventory": [
          {
            "section": "317",
            "row": "1",
            "seats": [
              1,
              2,
              3,
              4,
              5,
              6,
              7,
              8,
              9,
              10,
              11,
              12,
              13,
              14,
              15,
              16,
              17,
              18,
              19,
              20,
              21,
              22,
              23,
              24,
              25,
              26
            ],
            "places": [
              "GMYTOORRHIYQ",
              "GMYTOORRHIZA",
              "GMYTOORRHIZQ",
              "GMYTOORRHI2A",
              "GMYTOORRHI2Q",
              "GMYTOORRHI3A",
              "GMYTOORRHI3Q",
              "GMYTOORRHI4A",
              "GMYTOORRHI4Q",
              "GMYTOORRHIYTA",
              "GMYTOORRHIYTC",
              "GMYTOORRHIYTE",
              "GMYTOORRHIYTG",
              "GMYTOORRHIYTI",
              "GMYTOORRHIYTK",
              "GMYTOORRHIYTM",
              "GMYTOORRHIYTO",
              "GMYTOORRHIYTQ",
              "GMYTOORRHIYTS",
              "GMYTOORRHIZDA",
              "GMYTOORRHIZDC",
              "GMYTOORRHIZDE",
              "GMYTOORRHIZDG",
              "GMYTOORRHIZDI",
              "GMYTOORRHIZDK",
              "GMYTOORRHIZDM"
            ],
            "areas": [
              {
                "description": "Concourse 3",
                "name": "CON3",
                "areaId": "2",
                "areaLabel": "zone"
              }
            ],
            "attributes": [],
            "hasEvenOddMix": true
          },
          {
            "section": "317",
            "row": "2",
            "seats": [
              19,
              20,
              21,
              22,
              23,
              24,
              25,
              26
            ],
            "places": [
              "GMYTOORSHIYTS",
              "GMYTOORSHIZDA",
              "GMYTOORSHIZDC",
              "GMYTOORSHIZDE",
              "GMYTOORSHIZDG",
              "GMYTOORSHIZDI",
              "GMYTOORSHIZDK",
              "GMYTOORSHIZDM"
            ],
            "areas": [
              {
                "description": "Concourse 3",
                "name": "CON3",
                "areaId": "2",
                "areaLabel": "zone"
              }
            ],
            "attributes": [],
            "hasEvenOddMix": true
          },
          {
            "section": "330",
            "row": "9",
            "seats": [
              1,
              2
            ],
            "places": [
              "GMZTAORZHIYQ",
              "GMZTAORZHIZA"
            ],
            "areas": [
              {
                "description": "Concourse 3",
                "name": "CON3",
                "areaId": "2",
                "areaLabel": "zone"
              }
            ],
            "attributes": [],
            "hasEvenOddMix": true
          }
        ],
        "eventTicketLimit": 0
      }
      //

    ],
    "seatLocationMapRestrict": false,
    "locXnumAddescRestrict": false,
    "locRowSeatRestrict": false,
    "serviceFeeRollup": false,
    "facilityFeeRollup": false,
    "venueId": "263135"
  }
}           

Response with parameter getBasePrice=true

Request Response

https://app.ticketmaster.com/partners/v1/events/0B004D43F86C478F/availability?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne&getBaseprice=true
Status 200
{
  "event": {
    "id": "0B004D43F86C478F",
    "restrictSingle": false,
    "safeTixEnabled": false,
    "eventTicketLimit": 0,
    "onsale": "2016-04-29 17:00:00.0",
    "offsale": "2022-08-20 17:00:00.0",
    "eventDateTime": "2021-11-26 03:00:00.0",
    "granularPricing": false,
    "allInclusivePricing": false,
    "tickets": [
      {
        "offers": [
          {
            "ticketTypeId": "000000000001",
            "priceLevelId": "9",
            "currency": "USD",
            "faceValue": 50.5,
            "totalPrice": 49.4,
            "listPrice": 30,
            "charges": [
              {
                "reason": "facility",
                "type": "fee",
                "amount": 8
              },
              {
                "reason": "order_processing",
                "type": "fee",
                "amount": 0
              },
              {
                "reason": "service",
                "type": "fee",
                "amount": 15.8
              }
               {
                  "reason": "service",
                  "type": "tax",
                  "amount": 2
                },
                {
                  "reason": "face_value_tax",
                  "type": "tax",
                  "amount": 3
                },
                {
                "reason": "service_tax_2",
                "type": "tax",
                "amount": 0.33
                }
            ],
            "offerName": "GPAS1",
            "offerDescription": "GPAS1",
            "eventTicketMinimum": 1,
            "restrictedPayment": false,
            "sellableQuantities": [
              1,
              2,
              3,
              4,
              5,
              6,
              7,
              8,
              9,
              10
            ],
            "protected": false
          }
        ],
        "available": 536,
        "total": 1009,
        "seating": "reserved",
        "currentTicketLimit": 20,
        "inventory": [
          {
            "section": "328",
            "row": "11",
            "seats": [
              15,
              16,
              17,
              18
            ],
            "places": [
              "GMZDQORRGE5DCNI",
              "GMZDQORRGE5DCNQ",
              "GMZDQORRGE5DCNY",
              "GMZDQORRGE5DCOA"
            ],
            "areas": [
              {
                "description": "Concourse 3",
                "name": "CON3",
                "areaId": "2",
                "areaLabel": "zone"
              }
            ],
            "attributes": [],
            "hasEvenOddMix": true
          },
          {
            "section": "328",
            "row": "12",
            "seats": [
              1,
              2,
              3,
              4,
              5,
              6,
              7,
              8,
              9,
              10,
              11,
              12,
              13,
              14,
              15,
              16
            ],
            "places": [
              "GMZDQORRGI5DC",
              "GMZDQORRGI5DE",
              "GMZDQORRGI5DG",
              "GMZDQORRGI5DI",
              "GMZDQORRGI5DK",
              "GMZDQORRGI5DM",
              "GMZDQORRGI5DO",
              "GMZDQORRGI5DQ",
              "GMZDQORRGI5DS",
              "GMZDQORRGI5DCMA",
              "GMZDQORRGI5DCMI",
              "GMZDQORRGI5DCMQ",
              "GMZDQORRGI5DCMY",
              "GMZDQORRGI5DCNA",
              "GMZDQORRGI5DCNI",
              "GMZDQORRGI5DCNQ"
            ],
            "areas": [
              {
                "description": "Concourse 3",
                "name": "CON3",
                "areaId": "2",
                "areaLabel": "zone"
              }
            ],
            "attributes": [],
            "hasEvenOddMix": true
          }
          //

        ],
        "eventTicketLimit": 0
      },
      //

    ],
    "seatLocationMapRestrict": false,
    "locXnumAddescRestrict": false,
    "locRowSeatRestrict": false,
    "serviceFeeRollup": false,
    "facilityFeeRollup": false,
    "venueId": "263135"
  }
}  

Response for All-in Pricing Enabled Event

Request Response

https://app.ticketmaster.com/partners/v1/events/00005EAFA1A64023/availability?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne
Status 200
{
  "event": {
    "id": "00005EAFA1A64023",
    "universalId": "k7vGF9nX-t0ZN",
    "restrictSingle": false,
    "safeTixEnabled": true,
    "eventTicketLimit": 8,
    "onsale": "2023-05-19 14:00:00.0",
    "offsale": "2023-09-17 01:30:00.0",
    "eventDateTime": "2023-09-16 23:30:00.0",
    "granularPricing": false,
    "allInclusivePricing": true,
    "tickets": [
      {
        "offers": [
          {
            "ticketTypeId": "000600060003",
            "priceLevelId": "48",
            "currency": "USD",
            "faceValue": 25.00,
            "charges": [
              {
                "reason": "facility",
                "type": "fee",
                "amount": 2.0
              }
            ],
            "offerName": "GPAS1",
            "offerDescription": "GPAS1",
            "eventTicketMinimum": 1,
            "restrictedPayment": false,
            "sellableQuantities": [
              1,
              2,
              3,
              4,
              5,
              6,
              7,
              8
            ],
            "protected": false
          }
        ],
        "available": 192,
        "total": 200,
        "seating": "general",
        "currentTicketLimit": 8,
        "inventory": [
          {
            "section": "FLOOR",
            "seats": [],
            "places": [],
            "available": 192,
            "areas": [
              {
                "description": "Floor Section",
                "name": "FLOOR",
                "areaId": "4",
                "areaLabel": "zone"
              }
            ],
            "attributes": [],
            "hasEvenOddMix": false
          }
        ],
        "eventTicketLimit": 8
      }
    ],
    "seatLocationMapRestrict": false,
    "locXnumAddescRestrict": false,
    "locRowSeatRestrict": false,
    "venueId": "1330",
    "serviceFeeRollup": false,
    "facilityFeeRollup": false
  }
}

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

Pod Seating

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.

Request Response

http://app.ticketmaster.com/partners/v1/events/<eventId>/availability?apikey=<apikey>
Status 200
{
   "event":{
      "id":"20005A43DF5A8EA8",
      "universalId":"G5eZZp02LpIBI",
      "restrictSingle":false,
      "safeTixEnabled":false,
      "eventTicketLimit":0,
      "onsale":"2021-03-01 17:00:00.0",
      "offsale":"2021-12-29 03:00:00.0",
      "eventDateTime":"2021-12-29 03:00:00.0",
      "granularPricing":false,
      "tickets":[
         {
            "offers":[
               {
                  "ticketTypeId":"000028050009",
                  "priceLevelId":"4",
                  "currency":"USD",
                  "faceValue":4,
                  "charges":[
                 {
                   "reason": "facility",
                   "type": "fee",
                   "amount": 8
                 },
                 {
                   "reason": "order_processing",
                   "type": "fee",
                   "amount": 0
                 },
                 {
                   "reason": "service",
                   "type": "fee",
                   "amount": 15.8
                 }
                  {
                     "reason": "service",
                     "type": "tax",
                     "amount": 2
                   },
                   {
                     "reason": "face_value_tax",
                     "type": "tax",
                     "amount": 3
                   },
                   {
                   "reason": "service_tax_2",
                   "type": "tax",
                   "amount": 0.33
                   }
                  ],
                  "offerName":"EBR4",
                  "offerDescription":"EBR4",
                  "eventTicketMinimum":4,
                  "restrictedPayment":false,
                  "sellableQuantities":[
                     4
                  ]
               }
            ],
            "available":396,
            "total":396,
            "seating":"reserved",
            "currentTicketLimit":4,
            "inventory":[
               {
                  "section":"395",
                  "row":"7",
                  "seats":[
                     1,
                     2,
                     3,
                     4
                  ],
                  "places":[
                     "GM4TKORXHIYQ",
                     "GM4TKORXHIZA",
                     "GM4TKORXHIZQ",
                     "GM4TKORXHI2A"
                  ],
                  "areas":[
                     {
                        "description":"NOT Odd Sections",
                        "name":"EVENS",
                        "areaId":"13",
                        "areaLabel":"descriptive"
                     },
                     {
                        "description":"Level 300",
                        "name":"L300",
                        "areaId":"11",
                        "areaLabel":"zone"
                     },
                     {
                        "description":"Reserved Seating",
                        "name":"RESV",
                        "areaId":"6",
                        "areaLabel":"location"
                     }
                  ],
                  "attributes":[
                  ],
                  "hasEvenOddMix":true
               },
               {
                  "section":"319",
                  "row":"7",
                  "seats":[
                     1,
                     2,
                     3,
                     4
                  ],
                  "places":[
                     "GMYTSORXHIYQ",
                     "GMYTSORXHIZA",
                     "GMYTSORXHIZQ",
                     "GMYTSORXHI2A"
                  ],
                  "areas":[
                     {
                        "description":"NOT Odd Sections",
                        "name":"EVENS",
                        "areaId":"13",
                        "areaLabel":"descriptive"
                     },
                     {
                        "description":"Reserved Seating",
                        "name":"RESV",
                        "areaId":"6",
                        "areaLabel":"location"
                     },
                     {
                        "description":"Level 300",
                        "name":"L300",
                        "areaId":"11",
                        "areaLabel":"zone"
                     }
                  ],
                  "attributes":[
                  ],
                  "hasEvenOddMix":true
               }
            ],
            "eventTicketLimit":0
         }
      ],
      "seatLocationMapRestrict":false,
      "locXnumAddescRestrict":false,
      "locRowSeatRestrict":false,
      "venueId":"263135",
      "serviceFeeRollup":false,
      "facilityFeeRollup":false
   }
}