Partner API

The Ticketmaster Partner API, unlike the Discovery API, is not an open API. It is restricted to companies with whom Ticketmaster has existing, official distribution relationships.

The Ticketmaster Partner API lets clients reserve, purchase, and retrieve ticket and event information.

Release Notes

Click here to find the latest API feature releases.

Overview

Authentication

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

The key can be sent as a query parameter “apikey” or as a header “x-api-key”.

Example (using apikey as query parameter): https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart?apikey=3QIvq55bS608ai6r8moig1WdW57bONry

Host and API endpoint information

Environment	Endpoint
Pre-prod	https://app.ticketmaster.com/partners-preprod/v1
Production	https://app.ticketmaster.com/partners/v1

All connections must be made over SSL using https.

Production environment testing

Here you can test API transactions for different scenarios like credit card and invoice payment, captcha, etc. The following event ids are available for use:

* 1AeZZfEGkD0xtGV: Use this event ID for production environment testing

Universal Ids

Partner API will now use Universal Ids for all its endpoints . The universal Ids can be fetched using the Discovery Feed or Discovery API .

Best Practices

Cleanup

If a user abandons a page/tab after a ticket reserve has been made, client applications should do their best to detect this and issue a DELETE /cart request to free up allocated resources on the ticketing server. This should also be done if client apps no longer want to wait through a long, continuing polling process. This is necessary since ticket reserve requests that result in polling will eventually complete asynchronously and take up resources even if clients do not consume the next polling url.

Polling

Polling results from limited per-partner resources in the ticketing system. Clients should always be ready to handle polling responses. See polling for more details.

Terms and Conditions

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

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.

Support/FAQs

You can visit our support/FAQ page here.

Contact

Ticketmaster Developer Program devportalinquiry@ticketmaster.com.

Event Click Tracking Url [GET]

This is only available for partners signed up for affiliate tracking through Impact Radius

/partners/v1/tracking?event_id={event_id}&apikey={apikey}

Polling: No

Parameters

Parameter	Description	Type	Example	Required
`event_id`	The 15-digit alphanumeric event ID.	string	“1AeZZfEGkD0xtGV”	Yes
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes
`shared_id`	ImpactRadius SharedId field in reports (32 chars max)	string	“02a8127b-7a52”	No
`sub_id1,sub_id2,sub_id3`	ImpactRadius SubId1, SubId2, SubId3 fields in reports(32 chars max each)	string	“02a8127b-7a52”	No

https://app.ticketmaster.com/partners/v1/tracking?event_id=1AeZZfEGkD0xtGV&apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

Status 200

The Response is a 1x1 gif pixel

Event Information

The event information and metadata can be fetched using the Discovery Feed or Discovery API .

Reserve tickets and create a Cart [POST]

Reserves the specified tickets. For integrations requiring captcha, send the captcha solution token in the json body. A hold time will be returned in the cart response that will indicate, in seconds, how long the cart is available for. This value may increase if the user moves through the cart process.

The endpoint allows the following reserves using the additional reserves section in the request.

Ability to reserve non-adjacent seats.
Ability to reserve seats in difference price levels.
Ability to reserve seats in difference zones.

/partners/v1/events/{event_id}/cart?apikey={apikey}

Polling: Yes

Parameters

Parameter	Description	Type	Example	Required
`event_id`	The 15-digit alphanumeric event ID.	string	“1AeZZfEGkD0xtGV”	Yes
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes

Response structure:

Cart

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

{
    "token" : <captcha solution token, if required>, // Not used anymore and can be omitted from reserve request.

    "reserve" : {

        "tickets":[
            {
                "id": "000002040006", // Maintain leading-zeros in the ticket id as part of the string. 
                "quantity": 1,

                "price" : {
                    // Optional. For reserving best available within a price level discovered in Event Details.
                    "id" : 3,

                    // Optional. Only for accounts configured for variable-priced ticketing.
                    "amount" : 50.0
                }
            }
        ],

        // Optional.  For reserving best available within a specific area discovered in Event Details
        "areas" : [ { "id" : 2 } ],
        
				
        // Optional. Section/Row/Seat identifiers.  
        "section": "CLB239",
        "row": "C",
        "begin_seat": 17,
        "end_seat" : 18,

        // If the requested seats (via place id or begin/end seat) are not available, use a Best Available search as a fallback.  Set to false to disable. Default is true.
        "accept_best_available": false
    },
        // The additional reserves will allow to reserve non-adjacent seats, seats in difference price levels and seats in difference 
        zones.
    "additional_reserves": [
         {
           "tickets": [
             {
               "id": "000000000001",
               "quantity": 3
             }
           ],
           "section": "BALC",
           "row": "F",
           "begin_seat": 9,
           "end_seat" : 13
         },
         {
           "tickets": [
             {
               "id": "000000000001",
               "quantity": 1
             }
           ],
           "section": "MEZZ",
           "row": "DD",
           "begin_seat": 26
         }
     ]
}

Status 200
{
  "cart_id": "e4f1caf4-70a3-406c-a1dd-1e53478a3ec1",
  "cart": {
    "items": [
      {
        "type": "ticket",
        "id": 1,
        "view": {
          
        },
        "totals": {
          "currency_code": "USD",
          "fee": 0.0,
          "grand": 285.0,
          "merchandise": 285.0,
          "tax": 0.0
        },
        "areas": [
          {
            "description": "Price Level 1",
            "id": 3
          },
          {
            "description": "GENERAL ADMISSION STANDING",
            "id": 14
          }
        ],
        "tickets": [
          {
            "description": "Standard Ticket",
            "id": "000000000001",
            "quantity": 1,
            "inventory_type": "PRIMARY",
            "charges": [
              {
                "price": 0.0,
                "type": "distance",
                "quantity": 1,
                "tax": 0.0
              },
              {
                "price": 0.0,
                "type": "facility",
                "quantity": 1,
                "tax": 0.0
              },
              {
                "price": 285.0,
                "type": "face_value",
                "quantity": 1,
                "tax": 0.0
              },
              {
                "price": 0.0,
                "type": "service",
                "quantity": 1,
                "tax": 0.0
              }
            ]
          }
        ],
        "ga": true,
        "event_id": "2000527EE48A9334",
        "num_seats": 1,
        "x_num": 1,
        "section": "GAPIT1",
        "is_ga": true
      },
      {
        "type": "processing",
        "id": 2,
        "totals": {
          "currency_code": "USD",
          "fee": 0.0,
          "grand": 0.0,
          "merchandise": 0.0,
          "tax": 0.0
        }
      },
      {
        "type": "delivery",
        "id": 4,
        "carrier": "TICKETMASTER",
        "service_level": "ETICKET",
        "description": {
          "long": "Get in with:",
          "short": "eTickets",
          "eta": "eTickets"
        },
        "totals": {
          "currency_code": "USD",
          "fee": 0.0,
          "grand": 0.0,
          "merchandise": 0.0,
          "tax": 0.0
        },
        "requires_address": false
      }
    ],
    "totals": {
      "currency_code": "USD",
      "delivery": 0.0,
      "fee": 0.0,
      "grand": 285.0,
      "merchandise": 285.0,
      "tax": 0.0,
      "unpaid": 285.0,
      "upsell": 0.0
    },
    "hold_time": 298
  }
}

Response structure for Resale Cart

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

{
  "reserve": {
    "tickets": [
      {
        "id": "resale-listingVer-00000007cc84cd85:product-product-0000000002ccd249:product-variant-0000000612ba2495:1AeZZfEGkD0xtGV", 
        "quantity": 2
      }
    ]
  }
}

{
   "cart_id":"5408d2fd-da93-4f24-a8e9-2ade79435083",
   "cart":{
      "items":[
         {
            "type":"ticket",
            "id":1,
            "tickets":[
               {
                  "id":"resale-listingVer-00000007d6baab75:product-product-0000000002ccd249",
                  "quantity":2,
                  "inventory_type":"RESALE",
                  "charges":[
                     {
                        "price":11.97,
                        "type":"service",
                        "quantity":2,
                        "tax":0
                     },
                     {
                        "price":63,
                        "type":"face_value",
                        "quantity":2,
                        "tax":0
                     }
                  ],
                  "averageOriginalTotalValue":"59.35"
               }
            ],
            "ga":false,
            "totals":{
               "currency_code":"USD",
               "fee":23.94,
               "grand":149.94,
               "merchandise":126,
               "tax":0
            },
            "event_id":"0D005C92DEA7D1AE",
            "num_seats":2,
            "row":"15",
            "section":"307",
            "is_ga":false
         },
         {
            "type":"delivery",
            "id":1073,
            "totals":{
               "currency_code":"USD",
               "delivery":0,
               "fee":0,
               "grand":0,
               "tax":0
            },
            "service_level":"ETICKET",
            "description":{
               "long":"Get in with:",
               "short":"eTickets"
            },
            "rank":0,
            "requires_address":true
         },
         {
            "type":"processing", // For Resale ticket this will be the order processing fee. It is not visible in our TopPicks & Availability API. It is added to the cart only when the cart is reserved. 

            "totals":{
               "currency_code":"USD",
               "delivery":0,
               "fee":2.95,
               "grand":2.95,
               "merchandise":0,
               "tax":0,
               "unpaid":2.95,
               "upsell":0
            }
         }
      ],
      "totals":{
         "currency_code":"USD",
         "delivery":0,
         "fee":26.89,
         "grand":156.85,
         "merchandise":126,
         "tax":3.96,
         "unpaid":156.85,
         "upsell":0
      },
      "hold_time":0
   }
}

Response structure for All-in Pricing Cart

More details on the all-in pricing changes in Partner API here.

https://app.ticketmaster.com/partners/v1/events/00005EAFA1A64023/cart?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

{
  "reserve": {
    "tickets": [
      {
        "id": "000000000001",
        "quantity": 1
      }
    ]
  }
}

{
  "cart_id": "18dedae7-ab82-4295-9b67-c70a69fdfa9b",
  "cart": {
    "items": [
      {
        "type": "ticket",
        "id": 1,
        "areas": [
          {
            "description": "Center Section",
            "id": 0
          },
          {
            "description": "Loge Box Seating",
            "id": 2
          },
          {
            "description": "PRICE LEVEL 3",
            "id": 50
          }
        ],
        "tickets": [
          {
            "description": "Standard Admission",
            "id": "000000000001",
            "quantity": 1,
            "inventory_type": "PRIMARY",
            "charges": [
              {
                "price": 60,
                "type": "face_value",
                "quantity": 1,
                "tax": 0
              },
              {
                "price": 14.9,
                "type": "service",
                "quantity": 1,
                "tax": 0
              },
              {
                "price": 0,
                "type": "tax",
                "quantity": 0,
                "tax": 0
              }
            ]
          }
        ],
        "ga": false,
        "totals": {
          "currency_code": "USD",
          "fee": 14.9,
          "grand": 74.9,
          "merchandise": 60,
          "tax": 0
        },
        "event_id": "00005EAFA1A64023",
        "num_seats": 1,
        "x-num": 9,
        "row": "E",
        "section": "LOGEC",
        "start_seat_number": "103",
        "end_seat_number": "103",
        "is_ga": false
      },
      {
        "type": "processing",
        "id": 2,
        "totals": {
          "currency_code": "USD",
          "fee": 3.1,
          "grand": 3.1,
          "merchandise": 0,
          "tax": 0
        }
      }
    ],
    "totals": {
      "currency_code": "USD",
      "delivery": 0,
      "fee": 18,
      "grand": 78,
      "merchandise": 60,
      "tax": 0,
      "unpaid": 78,
      "upsell": 0
    },
    "hold_time": 299
  }
}

Shipping Options [GET]

Get shipping options available for this event.

Specifying the “region” query parameter will return options available for users in the selected country.

/partners/v1/events/{event_id}/cart/shipping?apikey={apikey}&cart_id={cart_id}&region={region}

Polling: No

Parameters

Parameter	Description	Type	Example	Required
`event_id`	The 15-digit alphanumeric event ID.	string	“1AeZZfEGkD0xtGV”	Yes
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes
`cart_id`	Card identifier. Must be url encoded.	string	“bzJVZURoNit1UkhQQ25pcE5KSHh1K09SVE9lQ0k2RktwSEZFdnAwTlNJYS82ZE5WWldiREtSTQo%3D”	Yes
`region`	2-digit country codes found here: http://www.nationsonline.org/oneworld/country_code_list.htm.	string	“CA”	No . By default, it returns US shipping options for events in US, CA, AU, and NZ, and GB shipping options for events in GB and IE.

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart/shipping?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne&cart_id=bzJVZURoNit1UkhQQ25pcE5KSHh1K09SVE9lQ0k2RktwSEZFdnAwTlNJYS82ZE5WWldiREtSTQo%3D

Status 200

{
  "shipping_options":[
    {
      "id": "307c01486adbjkwadwq96f75fe659b6c",
      "carrier": "TICKETMASTER",
      "service_level": "ETICKET",
      "requires_address": false,
      "description": {
        "long": "Get in with:",
        "short": "eTickets",
        "eta": "eTickets"
      },
      "totals": {
        "currency_code": "USD",
        "fee": 0.0,
        "grand": 0.0,
        "merchandise": 0.0,
        "tax": 0.0
      }
    },
    {
      "id": "5f4867621adbjakwdqwndcb9bd6676",
      "carrier": "UPS",
      "service_level": "2DAYPM",
      "requires_address": true,
      "description": {
        "long": "By 7:30 PM in 2 business days via UPS (no delivery to PO Box or APO/FPO addresses).",
        "short": "2 Business Day (Evening)",
        "eta": "2 Business Day (Evening)"
      },
      "totals": {
        "currency_code": "USD",
        "fee": 43.5,
        "grand": 43.5,
        "merchandise": 0.0,
        "tax": 0.0
      }
    },
    {
      "id": "3543cfe2e5c8ahgsdqdbae0ae7edeabf",
      "carrier": "UPS",
      "service_level": "3DAY",
      "requires_address": true,
      "description": {
        "long": "By 7:30 PM in 3 business days via UPS (no delivery to PO Box or APO/FPO addresses).",
        "short": "3 Business Day (Evening)",
        "eta": "3 Business Day (Evening)"
      },
      "totals": {
        "currency_code": "USD",
        "fee": 39.5,
        "grand": 39.5,
        "merchandise": 0.0,
        "tax": 0.0
      }
    },
    {
      "id": "c81e728d9ddhwudbwjd89cc14862c",
      "carrier": "TICKETMASTER",
      "service_level": "WILLCALL",
      "requires_address": false,
      "description": {
        "long": "Tickets held at Will Call can only be retrieved by the cardholder with original credit card of purchase and a valid photo ID with signature such as a state ID, driver's license or passport.",
        "short": "Will Call",
        "eta": "Will Call"
      },
      "totals": {
        "currency_code": "USD",
        "fee": 15.0,
        "grand": 15.0,
        "merchandise": 0.0,
        "tax": 0.0
      }
    },
    {
      "id": "c4ca4238abchajgadcc509a6f75849b",
      "carrier": "USPS",
      "service_level": "MAIL",
      "requires_address": true,
      "description": {
        "long": "Your tickets will be mailed to your billing address within 10 to 14 days of your purchase.",
        "short": "Standard Mail: Allow 10 to 14 days for delivery",
        "eta": "Standard Mail"
      },
      "totals": {
        "currency_code": "USD",
        "fee": 500.0,
        "grand": 500.0,
        "merchandise": 0.0,
        "tax": 0.0
      }
    }
  ]
}

Shipping Options [PUT]

Add a shipping option to the event. Note: some API users will be pre-configured for certain shipping options and may not need to perform this.

/partners/v1/events/{event_id}/cart/shipping?apikey={apikey}&cart_id={cart_id}

Polling: Yes

Parameters

Parameter	Description	Type	Example	Required
`event_id`	The 15-digit alphanumeric event ID.	string	“1AeZZfEGkD0xtGV”	Yes
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes
`cart_id`	Card identifier. Must be url encoded.	string	“bzJVZURoNit1UkhQQ25pcE5KSHh1K09SVE9lQ0k2RktwSEZFdnAwTlNJYS82ZE5WWldiREtSTQo%3D”	Yes

Response structure:

Cart

    https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart/shipping?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne&cart_id=bzJVZURoNit1UkhQQ25pcE5KSHh1K09SVE9lQ0k2RktwSEZFdnAwTlNJYS82ZE5WWldiREtSTQo%3D


    {"shipping_id": "5f4867621279e6246b2b254cb9bd6676"}

    Status 200

    {
      "cart": {
        "items": [
          {
            "type": "ticket",
            "id": 1,
            "view": {
              
            },
            "totals": {
              "currency_code": "USD",
              "fee": 0.0,
              "grand": 285.0,
              "merchandise": 285.0,
              "tax": 0.0
            },
            "areas": [
              {
                "description": "Price Level 1",
                "id": 3
              },
              {
                "description": "GENERAL ADMISSION STANDING",
                "id": 14
              }
            ],
            "tickets": [
              {
                "description": "Standard Ticket",
                "id": "000000000001",
                "quantity": 1,
                "inventory_type": "PRIMARY",
                "charges": [
                  {
                    "price": 0.0,
                    "type": "distance",
                    "quantity": 1,
                    "tax": 0.0
                  },
                  {
                    "price": 0.0,
                    "type": "facility",
                    "quantity": 1,
                    "tax": 0.0
                  },
                  {
                    "price": 285.0,
                    "type": "face_value",
                    "quantity": 1,
                    "tax": 0.0
                  },
                  {
                    "price": 0.0,
                    "type": "service",
                    "quantity": 1,
                    "tax": 0.0
                  }
                ]
              }
            ],
            "ga": true,
            "event_id": "2000527EE48A9334",
            "num_seats": 1,
            "x_num": 1,
            "section": "GAPIT1",
            "is_ga": true
          },
          {
            "type": "processing",
            "id": 2,
            "totals": {
              "currency_code": "USD",
              "fee": 0.0,
              "grand": 0.0,
              "merchandise": 0.0,
              "tax": 0.0
            }
          },
          {
            "type": "delivery",
            "id": 5,
            "carrier": "UPS",
            "service_level": "2DAYPM",
            "description": {
              "long": "By 7:30 PM in 2 business days via UPS (no delivery to PO Box or APO/FPO addresses).",
              "short": "2 Business Day (Evening)",
              "eta": "2 Business Day (Evening)"
            },
            "totals": {
              "currency_code": "USD",
              "fee": 43.5,
              "grand": 43.5,
              "merchandise": 0.0,
              "tax": 0.0
            },
            "requires_address": true
          }
        ],
        "totals": {
          "currency_code": "USD",
          "delivery": 43.5,
          "fee": 43.5,
          "grand": 328.5,
          "merchandise": 285.0,
          "tax": 0.0,
          "unpaid": 328.5,
          "upsell": 0.0
        },
        "hold_time": 338
      }
    }

Add Billing Information [PUT]

Add customer and billing information to the order. The following payment methods are available:

Credit cards (American Express, Visa, Mastercard, Discover)
Debit cards (issued by the above card brands)
Invoice

For Open Inventory Partners, credit card payments are supported in these markets: US, CA

For Channel Partners, invoice payment is supported in these markets: US, CA, UK, AU, NZ

Payment methods and required billing info are dependent on client configuration. Contact partnersupport@ticketmaster.com for your configuration.

https://app.ticketmaster.com/partners/v1/events/{event_id}/cart/payment?apikey={apikey}

Polling: No

Parameters

Parameter	Description	Type	Example	Required
`event_id`	The 15-digit alphanumeric event ID.	string	“1AeZZfEGkD0xtGV”	Yes
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes

Payment Tokenization

Partners can use a Braintree token to charge a user’s card or PayPal account. Braintree users can use the Grant API to share access to a payment method in their vault. Partners who don’t use Braintree can use with the Braintree client SDK or GraphQL API to create a token. Read Creating a Braintree token to learn more.

This request is used to add a Braintree token as payment method to the cart.

All fields are required except where noted

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart/payment?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

{
"cart_id": "3d7e57b4-7030-4600-9725-bfa62f44a9d6",
"payment": {
   "address": {
 	"city": "",
 	"country": {"code": "US"}, //use ISO country abbreviations https://www.nationsonline.org/oneworld/country_code_list.htm
 	                           //Required for all addresses outside of US.
 	"line1": "123 Main Street",
 	"line2": "",
 	"postal_code": "",
 	"region": {"abbrev":"CA"}
   },
   "amount": "69.00",
   "card": {
 	 "number": "braintree-token",
   "expireMonth": 12, //optional but preferred
   "expireYear": 2019, //optional but preferred
    "Issuer": "VISA" //optional
    },
   "email_address":"jdoe@ticketmaster.com",  // Max length: 128 characters
   "first_name": "John",  //Max length: 50 characters
   "last_name": "Doe",  //Max length: 50 characters
   "home_phone": "212-867-5309",
   "type": "BRAINTREE"
  }
}

Status 200
{
    "cart" : {
        ...
    }
}

This request is used to add a invoice payment method to the cart.

Polling: No
Authorization: Required

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart/payment?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne
{

  "cart_id": "983d4f3e-3bb5-4ea9-834a-37eee595db2a",
  "payment": {
      "address": {
      "city": "Los Angeles", 
      "country": {
      "code": "US"  //Required for all addresses outside of US.
      },
       "line1": "123 Main Street",
        "line2": "",
         "postal_code": "90210",
         "region": {
         "abbrev": "CA"
         }
       },
     "amount": "177.45",
     "email_address": "dc-eng@ticketmaster.com",
     "first_name": "John",
     "home_phone": "212-867-5309",
     "last_name": "Doe",
     "reference": "15278303", //Required for type=INVOICE only. The value should be a positive integer 16 characters long.
     "type": "INVOICE"
 }

Status 200
{
    "cart" : {
        ...
    }
}

Commit Cart [PUT]

Finalize the purchase and commit the transaction. source_account_id can be any unique identifier of the user (i.e. hash of member id). This is required for tracking bounces of ticket redemption emails.

/partners/v1/events/{event_id}/cart?apikey={apikey}

Polling: Yes
Authorization: Required for auto claim of ticket to member account

For now, the response is the same with or without the Authorization Header.

Parameters

Parameter	Description	Type	Example	Required
`event_id`	The 15-digit alphanumeric event ID.	string	“1AeZZfEGkD0xtGV”	Yes
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes

Properties

Response structure:

(object) - response
- redemption_url (url) - link to claim your tickets on ticketmaster
- grand_total (number) - Total value of the order
- currency_code (text) - Currency of the total value of the order
- order_token (text) - Order Token
- order_number (text) - HOST order ID

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne


{ 
    "cart_id" : "bzJVZURoNit1UkhQQ25pcE5KSHh1K09SVE9lQ0k2RktwSEZFdnAwTlNJYS82ZE5WWldiREtSTQo=",
    "source_account_id" : "30f86cd70ac7216bc596aa2d060a7064", // Optional, your reference number (or hash) to correlate unredeemed orders

    "tracking" : { // Optional, report tracking variables (see GET /tracking endpoint)

        "shared_id" : "1",
        "sub_id1" : "3",
        "sub_id2" : "4",
        "sub_id3" : "5"
    }
}

Status 200
{
    "redemption_url" : "https://myorder.ticketmaster.com/redeem?token=28a67e13-7233-45a5lsGPQy0MZ3J7ZOQRjcW52NHhG083D",
    "grand_total" : 57.39,
    "order_token" : "28a67e13-7233-45a5lsGPQy0MZ3J7ZOQRjcW52NHhG083D",
    "order_number" : "35-46145/LA1"
}

Redemption Email

Once the purchase is successfully completed, Ticketmaster will send the buyer the redemption URL. it is recommended that partners display it to the buyer. The URL is active until the buyer redeems the ticket. Partners can store the URL, however be advised that anyone who has the URL can redeem the ticket and could result in a customer service issue. Ticketmaster also sends reminders to the buyer until the ticket has been redeemed. Requesting a copy of the URL is not standard practice and we do not recommend relying on this as part of the integration process.

Delete Cart [DELETE]

Each partner has a limited amount of reservation resources that can be simultaneously in use. If the user abandons the reservation process, it is a good practice to manually delete the cart to allow these resources to be re-allocated. Increased polling may occur if carts are not cleaned up. Not required if the user finalizes the transaction

/partners/v1/events/1AeZZfEGkD0xtGV/cart?apikey={apikey}&cart_id={cart_id}

Parameters

Parameter	Description	Type	Example	Required
`event_id`	The 15-digit alphanumeric event ID.	string	“1AeZZfEGkD0xtGV”	Yes
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes
`cart_id`	Card identifier. Must be url encoded.	string	“bzJVZURoNit1UkhQQ25pcE5KSHh1K09SVE9lQ0k2RktwSEZFdnAwTlNJYS82ZE5WWldiREtSTQo%3D”	Yes

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne&cart_id=bzJVZURoNit1UkhQQ25pcE5KSHh1K09SVE9lQ0k2RktwSEZFdnAwTlNJYS82ZE5WWldiREtSTQo

Status 204

Polling [GET]

Resource endpoints that have polling enabled may alternatively return a json response with a polling url and wait time, along with http status code=202. This is used to inform client applications of long-waiting operations and queuing restrictions for particular actions in the Ticketmaster system.

Client applications may receive the following json response for any resource marked “Polling: Yes”.

{
    "polling_url": "https://app.ticketmaster.com/partners/v1/polling-status?token=0ee566f7-cbfe-43f4-93b9-117c8d69f3d0&cart_id=eb6d42b7-cb95-48a5-acba-56514cf0d6ef",
    "wait": 4,
    "cart_id": "eb6d42b7-cb95-48a5-acba-56514cf0d6ef"
}

Client applications should call polling_url with a GET request after waiting 4 seconds. It is possible that this request may also result in another polling response.

Clients can test polling by issuing the following header: X-TM-FORCE-POLLING: true to any of the endpoints marked “Polling: Yes”.

The output of the original action will eventually be returned in the body of the response.

/partners/v1/polling-status?token={token}&cart_id={cart_id}&apikey={apikey}

Parameters

Parameter	Description	Type	Example	Required
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes
`cart_id`	Card identifier. Must be url encoded.	string	“bzJVZURoNit1UkhQQ25pcE5KSHh1K09SVE9lQ0k2RktwSEZFdnAwTlNJYS82ZE5WWldiREtSTQo%3D”	Yes
`token`	token	string	“0ee566f7-cbfe-43f4-93b9-117c8d69f3d0”	Yes

https://app.ticketmaster.com/partners/v1/polling-status?token=0ee566f7-cbfe-43f4-93b9-117c8d69f3d0&cart_id=bzJVZURoNit1UkhQQ25pcE5KSHh1K09SVE9lQ0k2RktwSEZFdnAwTlNJYS82ZE5WWldiREtSTQo%3D&apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

Status 202
{
	"polling_url": "https://app.ticketmaster.com/partners/v1/polling-status?token=0ee566f7-cbfe-43f4-93b9-117c8d69f3d0&cart_id=eb6d42b7-cb95-48a5-acba-56514cf0d6ef",
	"wait": 4,
	"cart_id": "eb6d42b7-cb95-48a5-acba-56514cf0d6ef"
}

Status 200
{
    // json payload from originally requested response (status code = 200)

}

Order management [GET]

Get detailed information about an order using order token. For specifically-enabled accounts only.

/partners/v1/orders?order_token={order_token}?apikey={apikey}

OR using Cart Id. For specifically-enabled accounts only.

/partners/v1/orders?cart_id={cart_id}&event_id={event_id}&apikey={apikey}

Polling: Yes

Parameters

Parameter	Description	Type	Example	Required
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes
`order_token`	An order token	string	“28a67e13-7233-45a5lsGPQy0MZ3J7ZOQRjcW52NHhG083D”	No
`cart_id`	A cart id	string	“28a67e13-7233-45a5ls-22763vacd “	No
`event_id`	EventId	string	“1AeZZfEGkD0xtGV”	Yes, if using cart_id to find orders.

Response Sample for Host orders

https://app.ticketmaster.com/partners/v1/orders?order_token=28a67e13-7233-45a5lsGPQy0MZ3J7ZOQRjcW52NHhG083D?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

Status 200
{
    "customer_email": "joe.qa@ticketmaster.com",
    "tickets": [
        {
            "barcode_id": "8819624561542398",
            "barcode_display_date": {                
                "format": "datetime",
                "value": "2022-06-24T02:00:00Z"
             },
             "barcode_display_format": [             //Return the barcode_display_format (Mobile, Print at home, BOTH)for each ticket in the response. This example is if we have both option Mobile and Print at home

            {
             "delivery_method": "mobile",
             "render_type": "QR code"
            },
            {
             "delivery_method": "print-at-home",
             "render_type": "Interleaved 2 of 5"
            }
         ],
            "charges": [
                {
                    "amount": {
                        "amount": 66.0,
                        "currency": "USD"
                    },
                    "description": "Price",
                    "sub_type": "price",
                    "type": "price"
                },
                {
                    "amount": {
                        "amount": 0.0,
                        "currency": "USD"
                    },
                    "description": "Service Charge",
                    "sub_type": "service_charge",
                    "type": "fee"
                },
                {
                    "amount": {
                        "amount": 0.0,
                        "currency": "USD"
                    },
                    "description": "Facility Charge",
                    "sub_type": "facility_charge",
                    "type": "fee"
                },
                {
                    "amount": {
                        "amount": 0.0,
                        "currency": "USD"
                    },
                    "description": "Tax",
                    "sub_type": "tax",
                    "type": "tax"
                },
                {
                    "amount": {
                        "amount": 0.0,
                        "currency": "USD"
                    },
                    "description": "Distance Charge",
                    "sub_type": "distance_charge",
                    "type": "fee"
                }
            ],
            "display_id": "29-16792/PHX",
            "distance_charge": 0.0,
            "event_code": "EGOLD",
            "event_host": "PHX",
            "event_id": "3F004EC9D1EBBC76",
            "is_ga": false,
            "is_national_vip": false,
            "order_date": "2015-12-10",
            "order_number": "29-16792/PHX",
            "portal": "USE WEST GATES",
            "row": "K",
            "seat_id": "252313614",
            "seat_name": "16",
            "section": "CLB237",
            "voided": false
        }
    ],
    "delivery": {
        "carrier": "USPS",
        "description": {
            "short": "US Postal Mail"
        },
        "service_level": "MAIL"
    },
    "upsells": [],
    "voided": false
}

NOTES:

1. ETickets Ready: The Host supports a feature called eTickets Ready which allows clients to control when consumers can view eTickets (i.e., mobile and print-at-home tickets) on TM. An event programmer (EP) can set a visibility date for eTickets as an offset from the event date/time in minutes. For instance, if a client doesn’t want fans to view their tickets until 72 hours before the event, then an EP would set the visibility time to 4,320 minutes (# of days x 24 hours x 60 minutes/hour). It is the responsibility of consumer-facing apps to honor the setting and only render the tickets at the appropriate time. To that end, the Order Management API will return the barcode_display_date along with the order details when an event is enabled for eTickets Ready. If a ticketing source system has the ability to delay the delivery of tickets until a specific time, then it should implement the barcode_display_date.

2. Safetix: To support SafeTix events, the response will include a ‘delivery’ object indicating the the “service_level”: “SAFETIX”

"delivery": {
 "carrier": "TICKETMASTER",
 "service_level": "SAFETIX",
 "description": 
    {
      "short": "SafeTix Rotating Entry Token"
    }
}

Response Sample for MFX orders

https://app.ticketmaster.com/partners/v1/orders?order_token=mfx_es_c291224abdcdefge3ad&apikey=abcdefg9b9sVHgdvf24N7E

Status 200
{
   {
      "customer_email":"",
      "tickets":[
         {
            "barcode_id":"*+Q$7E ABA*",
            "barcode_display_date":{
               "format":"datetime",
               "value":"2023-07-01T18:00:00Z"
            },
            "barcode_display_format":[
               {
                  "delivery_method":"mobile",
                  "render_type":"QR Code"
               }
            ],
            "charges":[
               {
                  "amount":{
                     "amount":1.5,
                     "currency":"EUR"
                  },
                  "description":"Price",
                  "sub_type":"price",
                  "type":"price"
               },
               {
                  "amount":{
                     "amount":0,
                     "currency":"EUR"
                  },
                  "description":"Ticket Fees",
                  "sub_type":"fee",
                  "type":"fee"
               },
               {
                  "amount":{
                     "amount":0,
                     "currency":"EUR"
                  },
                  "description":"Booking Fees",
                  "sub_type":"fee",
                  "type":"fee"
               }
            ],
            "display_id":"5611110/ES",
            "distance_charge":0,
            "event_code":"35101",
            "event_host":"MFX-ES",
            "event_id":"Z69acfacqZaF0q",
            "is_ga":false,
            "is_national_vip":false,
            "order_date":"2023-04-12",
            "order_number":"5639980/ES",
            "portal":"",
            "row":"1",
            "seat_id":"P-A-1-2",
            "seat_name":"2",
            "section":"A",
            "voided":false
         },
         {
            "barcode_id":"*0U2J561+.*",
            "barcode_display_date":{
               "format":"datetime",
               "value":"2023-07-01T18:00:00Z"
            },
            "barcode_display_format":[
               {
                  "delivery_method":"mobile",
                  "render_type":"QR Code"
               }
            ],
            "charges":[
               {
                  "amount":{
                     "amount":1.5,
                     "currency":"EUR"
                  },
                  "description":"Price",
                  "sub_type":"price",
                  "type":"price"
               },
               {
                  "amount":{
                     "amount":0,
                     "currency":"EUR"
                  },
                  "description":"Ticket Fees",
                  "sub_type":"fee",
                  "type":"fee"
               },
               {
                  "amount":{
                     "amount":0,
                     "currency":"EUR"
                  },
                  "description":"Booking Fees",
                  "sub_type":"fee",
                  "type":"fee"
               }
            ],
            "display_id":"563111810/ES",
            "distance_charge":0,
            "event_code":"35101",
            "event_host":"MFX-ES",
            "event_id":"Z698xZ2qZaF0q",
            "is_ga":false,
            "is_national_vip":false,
            "order_date":"2023-04-12",
            "order_number":"5631110/ES",
            "portal":"",
            "row":"1",
            "seat_id":"P-A-1-1",
            "seat_name":"1",
            "section":"A",
            "voided":false
         }
      ],
      "delivery":{
         "carrier":"TICKETMASTER",
         "description":{
            "short":"PAPI",
            "long":"Partner API"
         },
         "service_level":"Mobile"
      },
      "upsells":[
      ],
      "voided":false,
      "ticket_text_lines": [
        {
            "number": 1,
            "contents": "PROHIBIDA LA ENTRADA A MENORES DE 3 AÑOS."
         },
         {
            "number": 2,
            "contents": "Permitida la entrada a menores de 16 acompañados de un adulto + autorización."
         },
         {
             "number": 3,
             "contents": "Menores de 18 años deberán identificarse."
         },
         {
              "number": 4,
              "contents": "Consultar Política de menores en la web."
         }
      ]
}

Response Sample for Universe orders

https://app.ticketmaster.com/partners/v1/orders?order_token=universe_4d909141abcdefgghabcdefgh48a7b9bfc80f81e28573081&apikey=abcdefg9b9sVHgdvf24N7E

Status 200
 {
  "tickets" : [ {
    "barcode_id" : "C3WD21TYB",
    "barcode_display_format" : {
      "delivery_method" : "mobile",
      "render_type" : "QR code"
    },
    "barcode_display_date" : {
      "format" : "datetime",
      "value" : "2023-05-17T23:54:44Z"
    },
    "charges" : [ {
      "amount" : {
        "amount" : 30.0,
        "currency" : "USD"
      },
      "description" : "BASIC",
      "sub_type" : "price",
      "type" : "price"
    }, {
      "amount" : {
        "amount" : 1.75,
        "currency" : "USD"
      },
      "description" : "facility_fee",
      "sub_type" : "facility_fee",
      "type" : "fee"
    }, {
      "amount" : {
        "amount" : 3.22,
        "currency" : "USD"
      },
      "description" : "service_fee",
      "sub_type" : "service_fee",
      "type" : "fee"
    } ],
    "display_id" : "64656944a9a70e0001671c17",
    "event_id" : "LvZ18_vIvyGgDfYZvC4Gg",
    "is_ga" : true,
    "portal" : "1234 Market St",
    "order_date" : "2023-05-17T00:00:00.000Z",
    "order_number" : "64656944a9a70e0001671c17",
    "row" : "",
    "seat_name" : "",
    "section" : "",
    "voided" : false
  } ],
  "delivery" : {
    "carrier" : "TICKETMASTER",
    "description" : {
      "short" : "Standard Mail"
    },
    "service_level" : "ETICKET"
  },
  "voided" : false,
  "tm_sends_redemption_claim_email" : false,
  "third_party_source" : "EBG Vegas",
  "customer_email" : "abc.def@xyz.com"
}

Mobile Ticket Display Requirements

Ticket Attributes:

The following attributes should appear on each ticket:

Attribute	Description	Data Source
Event name	Name of event	Discovery API
Venue	Name of venue	Discovery API
Event Date	The event start date in local date	Discovery API
Event Time	The event start time in local time	Discovery API
Seat Section	The section of the seat	Order Management API
Seat Row	The row of the seat	Order Management API
Seat Number	The seat number	Order Management API
Portal	The venue entry and exit information for the seat	Order Management API
Order Number	The order number	Order Management API
Ticket Text	Information about the seat (only applicable when eventSource=MFX)	Order Management API

Barcode Display Format:

If the event is using a static barcode, render the barcode for each ticket in barcode_display_format.

If the event is using a SafeTix rotating barcode, use the Secure Entry SDK to render the token in secure_entry_data for each ticket.

Channel Indicator

For Ticketmaster US, CA, IE, AU and NZ events using a mobile QR code, you will need to append the channel indicator for Distributed Commerce to the barcode_id. The channel indicator helps Ticketmaster clients to identify the sales channel for mobile QR codes in reporting. You can either append the letter ‘i’ or ‘I’ as the 17th character to the barcode_id to identify Distributed Commerce as the sales channel for the ticket.

The channel indicator is not required for the following types of events:

Ticketmaster events located outside of US, CA, IE, AU and NZ (when eventSource = MFX)
Ticketmaster events using SafeTix
Universe (when eventSource = Universe)

Unredeemed orders [GET]

Retrieve unredeemed orders within a given time period. Some orders may have had bad email addresses, or emails that went to spam. Use your app’s notification features to notify the user of an unredeemed order. This endpoint requires IP-address whitelisting. Please contact us for details.

/partners/v1/orders/unredeemed?apikey={apikey}

Parameters

Parameter	Description	Type	Example	Required
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes
`days_from_purchase`	Number of days since purchase was made. This or days_before_event is required.	string	””	No
`days_before_event`	Number of days before event date.	string	””	No

https://app.ticketmaster.com/partners/v1/orders/unredeemed?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

Status 200
{
    "data" : [
        {
            "purchase_date_time" : 1441341339000, // milliseconds since unix epoch

            "email_status": 2, // 1=Sent (additional status unknown), 2=Bounced, 3=Spam, 4=Send Error

            "event_date_time": 1471737600000,
            "event_id" : "3F004EC9D1EBBC76",
            "order_source_account_id" : "fb63e3ede36210317e9e0fc5efccbc1f", // same value supplied with original order purchase

            "purchase_email_address" : "john.tester@gmail.com" // email address supplied with original order purchase

        }
    ]
}

Order Redemption Status [GET]

Retrieve the redemption status of an order. The response will indicate if the tickets are “redeemed” or “available”. This endpoint is available For specifically-enabled accounts only.

/partners/v1/status?token={token}&apikey={apikey}

Parameters

Parameter	Description	Type	Example	Required
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes
`token`	An order token	string	“28a67e13-7233-45a5lsGPQy0MZ3J7ZOQRjcW52NHhG083D”	Yes

http://app.ticketmaster.com/partners/v1/status?token={token}&apikey={apikey}

Status 200
{
    "event_id": "20005B14AB16A167",
    "order_number": "25-19520/AGF",
    "order_create_date": "2021-09-29T12:46:30Z",
    "status": "available",
    "redemption_email_delivery_date": "2021-09-29T12:46:31Z"
}

Status 401 // If not authorized you will receive 401 error

{
  "error" : {
    "message" : "Unauthorized",
    "code" : 401,
    "http_code" : 401,
    "severity" : "ERROR"
  }

Update : The redemption status of an order now also includes the voided status of each seat in an order. The voided status is true if the ticket has been voided. Below is a sample of the new response format.

Status 200
{
  "event_id" : "20005B14AB16A167",
  "order_number" : "25-36582/AGF",
  "order_create_date" : "2022-05-27T21:06:59Z",
  "status" : "available",
  "redemption_email_delivery_date" : "2022-05-27T21:07:03Z",
  "tickets" : [ {
    "order_date" : "2022-05-27",
    "order_number" : "25-36582/AGF",
    "row" : "U",
    "seat_name" : "101",
    "section" : "ORCH",
    "voided" : true
  }, {
    "order_date" : "2022-05-27",
    "order_number" : "25-36582/AGF",
    "row" : "U",
    "seat_name" : "102",
    "section" : "ORCH",
    "voided" : true
  }, {
    "order_date" : "2022-05-27",
    "order_number" : "25-36582/AGF",
    "row" : "U",
    "seat_name" : "103",
    "section" : "ORCH",
    "voided" : false
  }, {
    "order_date" : "2022-05-27",
    "order_number" : "25-36582/AGF",
    "row" : "U",
    "seat_name" : "104",
    "section" : "ORCH",
    "voided" : false
  } ]
}

Refund orders [POST]

For specifically-enabled accounts.

Cancel an order that you previously created. When an order is canceled, the seats will be returned to inventory and placed on sale again, but you must return the funds to the credit or debit card that was originally charged. You can only cancel the full order, and you can only cancel one order at a time.

/partners/v1/refund?apikey={apikey}&order_token={order_token}

Polling: Yes

Parameters

Parameter	Description	Type	Example	Required
`apikey`	Your API Key	string	“GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne”	Yes
`order_token`	An order token	string	“28a67e13-7233-45a5lsGPQy0MZ3J7ZOQRjcW52NHhG083D”	Yes
`dc_extra_notes`	A note for the refund.	string (Maximum of 80 chars)	“Refund approved by John Smith on 3/1/24.”	No

https://app.ticketmaster.com/partners/v1/refund?apikey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne&order=28a67e13-7233-45a5lsGPQy0MZ3J7ZOQRjcW52NHhG083D

{"notes": " Refund approved by John Smith on 3/1/24."}

Status 200 
{
    "customer_email": "john.smith@ticketmaster.com",
    "third_party_source": "Distributed Commerce Partner",
    "delivery": {
        "carrier": "TICKETMASTER",
        "service_level": "MOBILE",
        "description": {
            "short": "Mobile Entry"
        }
    },
    "tickets": [
        {
            "display_id": "43-10277/PHX",
            "event_code": "EDA0819",
            "event_host": "PHX",
            "event_id": "3F005CCDB4B4D9B3",
            "is_ga": true,
            "is_printed": false,
            "is_national_vip": false,
            "order_date": "2024-05-08",
            "order_number": "43-10277/PHX",
            "portal": "GA STANDING",
            "row": "GA3",
            "seat_id": "84082692",
            "seat_name": "56",
            "section": "GAFLR",
            "voided": true,
            "charges": [
                {
                    "description": "Price",
                    "sub_type": "price",
                    "type": "price",
                    "amount": {
                        "amount": 0.00,
                        "currency": "USD"
                    }
                },
                {
                    "description": "Distance Charge",
                    "sub_type": "distance_charge",
                    "type": "fee",
                    "amount": {
                        "amount": 0.00,
                        "currency": "USD"
                    }
                },
                {
                    "description": "Facility Charge",
                    "sub_type": "facility_charge",
                    "type": "fee",
                    "amount": {
                        "amount": 0.00,
                        "currency": "USD"
                    }
                },
                {
                    "description": "Service Charge",
                    "sub_type": "service_charge",
                    "type": "fee",
                    "amount": {
                        "amount": 0.00,
                        "currency": "USD"
                    }
                },
                {
                    "description": "Tax",
                    "sub_type": "tax",
                    "type": "tax",
                    "amount": {
                        "amount": 0.00,
                        "currency": "USD"
                    }
                }
            ]
        }
    ],
    "voided": true,
    "tm_sends_redemption_claim_email": true
}

Error Responses

message	http_code	Note
Order not found	404	Unable to find order number
Order is not eligible for a refund	403	Order does not pass the refund eligibility checks

Error Responses

Client or API-side errors will generate a json-formatted response body as well as standard HTTP status codes.

Example:

{
    "error": {
        "message" : "Invalid input data type",
        "code": 10002,
        "http_code":400,
        "severity":"ERROR"
    }
}

message	code	http_code	Note
Unauthorized access	10004	401	Captcha solution token required
Event is not API transactable	90001	403	Event type is not supported through this API. Offer redirect to https://www.ticketmaster.com/event/{eventId}
No inventory found to match request	20052	400	Example of sold-out tickets, per ticket id. Can also occur if the number of available continuous seats cannot be fulfilled
Unauthorized Access	10004	401	Missing captcha token
Invalid captcha solution	10031	400	Invalid captcha solution
Payment Not Accepted	20122	400
Please enter a valid security code	20152	400	Invalid CVV/Security code on back of credit card
Ticketing system is down/unavailable/niterun	20001	503	Typically the niterun hours are 2am - 4am local time
Invalid cart	90003	400	cart_id parameter is invalid or stale
Invalid Delivery Method ID	10104	400
Event had no visible/usable ticket types for the current channel	20046	400	API user is not configured to sell the specified ticket types
Payment method has no funds available	20129	400
Connection error to upstream service	502	502
Upstream service timeout	504	504
Payment has been rejected, retry permitted.	20130	400

Clients can reference the code field when communicating and debugging errors with Ticketmaster. We will automatically be notified of any internal, unrecoverable errors.

Cart

(object) - Cart Response
- cart_id (string) - Cart ID
- cart (object) - Cart
  - hold_time (number) - Cart expiry time in seconds
  - items (array) - Items
    - {arrayitemobject} - item
      - item (object) - This item could be of type “Tickets, Delivery or Processing”.They are described in detail below.
  - totals (object) - Totals
    - currency_code (text) - Currency Eg. “USD”
    - fee (number) - Total Fees (Includes Fees and Delivery)
    - grand (number) - Grand total (This value is equal to the merchandise + fees + taxes.)
    - merchandise ( number) - Total base value of the items. Excludes fees, taxes, and delivery
    - delivery (number) - Total Delivery charge
    - tax (number) - Total Tax
    - unpaid (number) - Total Unpaid balance
    - upsell (number) - Upsell

Cart Item - Tickets

(object) - Tickets
- id (number) - Item id
- type (text) - Type ‘ticket’
- x_num (number) - For Host-based inventory only
- event_id (text) - Event Id Eg. “3F004CBB88958BF9”
- num_seats (number) - Number of seats
- row (text) - Name of Row Eg. “I”
- section (text) - Section Name Eg. “MEZZ” for Mezzanine
- start_seat_number (number) - Begin Seat Number
- end_seat_number (number) - End Seat Number
- is_ga (boolean=true/false) - true if general admission else false.
- totals (object) - Totals
  - currency_code (text) - Currency Eg. “USD”
  - fee (number) - Total Fees
  - grand (number) - Grand total
  - merchandise ( number) - Total base value of the items. Excludes fees, taxes, and delivery
  - tax (number) - Total Tax
- areas (array) - Areas
  - {arrayitemobject} - area
    - description (text) - Description of the area or price level Eg. “100 Level” or “Price Level 6”
    - id (number) - Area ID
- tickets (array) - Tickets
  - {arrayitemobject} - Ticket
    - description (text) - Offer name
    - id (text) - Ticket type ID
    - quantity (number) - Number of tickets reserved
    - inventory_type (string) - Primary or Resale
    - charges (array) - Charges
      - {arrayitemobject} - Charge
        
        price (number)
        
        quantity (number)
        
        tax (number)
        
        type (text) - Type of charge Eg. distance, face_value, facility, service etc.

Cart Item - Delivery

(object) - Delivery
- id (number) - Item id
- type (text) - Type ‘delivery’
- carrier (string) - e.g. “TICKETMASTER”
- service_level (string) - Type of Delivery. e.g.”ETICKET”
- description (object) - Description
  - long (text) - Eg. “Get in with:”
  - short (text) - Eg. “etickets”
  - eta (text) - Eg. “etickets”
- totals (object) - Totals
  - currency_code (text) - Currency Eg. “USD”
  - fee (number) - Total Fees
  - grand (number) - Grand total
  - merchandise ( number) - Total base value of the items. Excludes fees, taxes, and delivery
  - tax (number) - Total Tax

Cart Item - Processing

(object) - Processing
- id (number) - Item id
- type (text) - Type ‘processing’
- totals (object) - Totals
  - currency_code (text) - Currency Eg. “USD”
  - fee (number) - Total Fees
  - grand (number) - Grand total
  - merchandise ( number) - Total base value of the items. Excludes fees, taxes, and delivery
  - tax (number) - Total Tax

Payment Section - This section is added to Cart Response after adding billing

payments (array) - Payments
- {arrayitemobject} - Payment
  - id (number) - Item id
  - payment_id (number) - Payment Id
  - type - Type of Payment (INVOICE,CC)
  - amount - Amount charged
  - card (object) - Card (This included only if Payment type is not Invoice)
    - expire_month (number) - Expiration month
    - expire_year (number) - Expiration year
    - issuer (text) - Issuer of card
    - number (text) - Last Four Digits for CC used.

Payment Request

payment (object) - Payment
- first_name (string) - First name of buyer. Max length : 50 characters
- last_name (string) - Last name of buyer. Max length : 50 characters
- home_phone (string) - Phone number
- type (string) - Valid values: CC, INVOICE, APPLE_PAY, GOOGLE_WALLET
- email_address (string) - Email address of user. Max length : 128 characters
- amount (number) - Amount to be charged
- reference (string) - Required for type=INVOICE only. Your numeric string-quoted reference number for this invoice transaction.
- address (object) - Address
  - line1 (string) - Address line 1
  - line2 (string) - Address line 2
  - unit (string) - Unit number
  - city (string) - City
  - country (object) - Country
    - code (string) - Required, use ISO country abbreviations http://www.nationsonline.org/oneworld/country_code_list.htm
  - region (object) - Region
    - abbreb (string) Region abbreviation
  - postal_code (string) - Postal/Zip code
- card (object) - Card information is used only for(Wallet,Member Id Payment).Data is different based on the Type of Payment used(Described in detail below).

Wallet Token Payment (Wallet anonymous)

card (object) - Card
- number (string) - Wallet Token generated
- cin (string) - Cvv number

Member Id Payment (Wallet)

card (object) - Card
- cin (string) - Encrypted cvv number (CC type only)
- encryption_key (string) - Encryption certificate id (see certificate docs earlier, CC type only)

Order Response Structure

(object) - Order Response
- customer_email (string) - Customer Email ID
- third_party_source (string) - Name of the Partner who placed the order
- delivery (object) - Delivery method for the order
  - carrier (string) -
  - service_level (string)
  - description (object)
    - short (string) - Description of the Ticket delivery method.
  - tickets (array) - List of Tickets purchased
    - {ticketitemobject} - Ticket
      - {barcodedateobject} - Barcode Display date object is used when there are delivery delays for an event.
        
        format (text) -Format of the display date
        
        value (text) - Value of teh barcode display date
      - barcode_display_format (array) - Barcode Display format array.
        
        {barcode_display_format_object} - Barcode Display format object.
        
        delivery_method (text) - Delivery Method of the Barcode (Mobile or Print at Home)
        
        render_type (text) - Render type of the Barcode (ex QR Code and/or Interleaved 2 of 5)
      - barcode_id (string) - Barcode id of this ticket
      - display_id (string) - Ticketmaster order number for this ticket Eg. 1-23454/NY1
      - event_code (string) - Event code as programmed in the host system.
      - event_host (string) - Host of the event Eg. NY1, UK2 etc.
      - event_id (string) - Ticketmaster event ID.
      - is_ga (boolean=true/false) - true if the ticket is for General Admission.
      - is_national_vip (boolean) -
      - order_date (string) - Date the order was placed
      - order_number (string) - Ticketmaster order number Eg. 1-23454/NY1
      - portal (string) -
      - row (string) - Row of the seat
      - seat_id (string) - Id of the seat
      - seat_name (string) - Description/Name of the seat if applicable.
      - section (string) - Section of the ticket
      - voided (boolean) - True if the seat/ticket is canceled/refunded.
      - charges (array) - Charges
        
        {chargeitemobject} - Charge
        
        description (text) - Description of the charge Eg. Price, Facility fee, Service charge etc.
        
        sub_type (text) - Subtype of the charge
        
        type (string) - Type of charge Eg. price, fee, tax etc
        
        amount (object)
        
        amount (number) - Amount charged
        
        currency (text) - Currency Eg. “USD”
      - secure_entry_data (object) Only applicable for Safetix enabled events
        
        render_type (string)
        
        segment_type (string)
        
        token (string) - Secure Entry Token
- voided(boolean=true/false) - true if the ticket is voided/refunded.
- additional_info(object) - Only applicable for Safetix enabled events
  - safetix_delivery_delay_date (string) - Delivery Delay Date for SafeTix-enabled events (only applicable to partners who want to sell SafeTix-enabled events before completing the SafeTix integration)
- device_id (string) - Only applicable for Safetix enabled events. Id of the device used for purchase.
- device_type (string) - Only applicable for Safetix enabled events. Type of the device used.
- device_os (string) - Only applicable for Safetix enabled events. IOS /ANDROID device
- nfc_capable_device (boolean) - Only applicable for Safetix enabled events.
- third_party_account_id (string) - Only applicable for Safetix enabled events. Third Party account id sent in when adding payment.

Notes

Customer Information

We use the following pieces of customer information when placing an order through the API.

First name
Last name
Email - We use email to send the customer their claim link.
Phone number
Zip code - this piece of data becomes optional when we get email address because we just need a third piece of data for the box office to use in case there are two customers with same name.
Address - In case the customer selects mail option for ticket delivery.

When a customer clicks on their claim link, they will be asked to log into their TM account or create one.

Note: Required Customer Data in API For claim process, the API requires:

email_address
first_name
last_name

Extra Information

Partners can send in extra information about the purchase using the dc_extra_notes variable when adding payment.

https://app.ticketmaster.com/partners/v1/events/030054EB99C747AE/cart/payment?apikey={apikey}
{
  "cart_id": "4100b400-c167-4b6c-97f7-a0e355cabf1a",
  "payment": {
    "address": {
      "city": "Los Angeles",
      "country": {"code": "US"},
      "line1": "123 Main Street",
      "line2": "",
      "postal_code": "90210",
      "region": {"abbrev": "CA"}
    },
    "amount": "59.00",
    "email_address": "dc-eng@ticketmaster.com",
    "first_name": "John",
    "home_phone": "212-867-5309",
    "last_name": "Doe",
    "reference": "123456",
    "third_party_account_id": "",
    "type": "INVOICE",
    "dc_extra_notes": "order transaction ID 123456789" //Max 80 char limit
    "extra1":    //This field is deprecated. Use dc_extra_notes.
  }
}

Status 200
{
    // Same cart response when adding payment

}

Partner Channel Source (Reseller) Information

Partners can send the reseller name using the new field called “partner_channel_source” to Commit Cart endpoint. We recommend using a consistent name for each reseller for accurate sales reporting.

https://app.ticketmaster.com/partners/v1/events/{event_ID}/cart?apikey={api_key}
{
    "cart_id": "5e9386a4-654c-412f-a320-994fa16b42bc",
    "partner_channel_source": "Expedia"
}

Status 200
{
    "redemption_url": "https://myorder.ticketmaster.net/redeem?token=AQECAHhHuUuvQjnuwR1iNaRYVhQOHtjy7FQ1oLiGggWLEycHagAAAM4wgcsGCSqGSIb3DQEHBqCBvTCBugIBADCBtAYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAxwhqFPEy22IgTpB9QCARCAgYYs_8PwLPHBa4XrhSGkFBUxH6Hu21YkPrxc6JeTQWWe7GFn1NtQYMHUHz9dkb6AutCohzuZVKUwByBAqXukRF2C_lJbTExpaorY1gB2tj6ihmHbl_JyY_MMnWvXBp59ppdhGaEBljU-XapLTlvn3IFTkSqwpIVV13rJzFJNIO54jWUGruS4lw&tmId=3F0054F2C1B98623",
    "grand_total": 103,
    "order_token": "AQECAHhHuUuvQjnuwR1iNaRYVhQOHtjy7FQ1oLiGggWLEycHagAAAM4wgcsGCSqGSIb3DQEHBqCBvTCBugIBADCBtAYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAxwhqFPEy22IgTpB9QCARCAgYYs_8PwLPHBa4XrhSGkFBUxH6Hu21YkPrxc6JeTQWWe7GFn1NtQYMHUHz9dkb6AutCohzuZVKUwByBAqXukRF2C_lJbTExpaorY1gB2tj6ihmHbl_JyY_MMnWvXBp59ppdhGaEBljU-XapLTlvn3IFTkSqwpIVV13rJzFJNIO54jWUGruS4lw",
    "order_number": "9-20111/PHX",
    "currency_code": "USD",
    "tm_app_url": "ticketmaster:///redeem/partners?token=AQECAHhHuUuvQjnuwR1iNaRYVhQOHtjy7FQ1oLiGggWLEycHagAAAM4wgcsGCSqGSIb3DQEHBqCBvTCBugIBADCBtAYJKoZIhvcNAQcBMB4GCWCGSAFlAwQBLjARBAxwhqFPEy22IgTpB9QCARCAgYYs_8PwLPHBa4XrhSGkFBUxH6Hu21YkPrxc6JeTQWWe7GFn1NtQYMHUHz9dkb6AutCohzuZVKUwByBAqXukRF2C_lJbTExpaorY1gB2tj6ihmHbl_JyY_MMnWvXBp59ppdhGaEBljU-XapLTlvn3IFTkSqwpIVV13rJzFJNIO54jWUGruS4lw"
}

Co-Branding Partner Name and Logo Information

In the claim flow, to co-brand the claim page and email, partners can share with us the image and name that needs to be used. The image is uploaded on to our CDN and the URL is shared back with the partner. Partner can then use that URL in our commit cart request with attributes_overrides.

{
    "cart_id": "c745c1a7-fbed-4b52-b650-e130f1a849bf",
    "attribute_overrides" : {
        "images" : {
            "email_1x" : "https://dcassets.pub-tmaws.io/assets/images/ABC.png",
            "1x" : "https://dcassets.pub-tmaws.io/assets/images/ABC.png",
            "web_1x" : "https://dcassets.pub-tmaws.io/assets/images/ABC.png"
        }
    }
}

Based on the image URL received in the request, we customize the claim page and the email with specific partner name and image.

Fees and Taxes Information

Fee/Tax	Description	Visible in Top Picks and/or Availability API	Per Ticket/Per Order	API Field Name
Face Value	The established price or base ticket price. Ticketmaster collects the face value and remits it to the client.	Yes	Per Ticket	“faceValue”
Face Value Tax	City, state, and local taxes assessed on the face value.	Yes	Per Ticket	“reason”: “face_value_tax”, “type”: “tax”
Facility Fee	A facility charge assessed by clients to help them operate and invest in their venues. Ticketmaster does not share in facility charges.	Yes	Per Ticket	“reason”: “facility”, “type”: “fee”
Service Fee	Ticketmaster adds a service fee (also known as a convenience charge) to the face value price, or in the case of a resale ticket to the listing price, of each ticket. The fee varies by event based on agreement with each client and is typically shared with the client.	Yes	Per Ticket	“reason”: “service”, “type”: “fee”
Service Tax	City, state, and local taxes assessed on the service fee.	Yes	Per Ticket	“reason”: “service_tax”, “type”: “tax”
Service Tax 2	City, state, and local taxes assessed on the service fee, typically used where there is more than one taxing entity in the same jurisdiction (e.g. City of Chicago and Cook County).	Yes	Per Ticket	“reason”: “service_tax_2”, “type”: “tax”
Order Processing Fee (Primary Tickets)	The order processing fee offsets the costs the cost of ticket handling, shipping, order processing and support. The fee is typically shared with Ticketmaster clients.	Yes	Per Order	“reason”: “order_processing”, “type”: “fee”
Order Processing Fee (Resale Tickets)	The resale order processing fee is not available in our TopPicks & Availability API. It is added to the cart only when the cart is reserved. It will come up as a separate line item.	No	Per Order	“type”: “processing”, “totals”: {“currency_code”: “USD”,”delivery”: 0, “fee”: 2.95,”grand”: 2.95,”merchandise”: 0,”tax”: 0, “unpaid”: 2.95, “upsell”: 0 }
Delivery Fee	Delivery options are determined by Ticketmaster clients and can vary by event. Ticketmaster offers a variety of ticket delivery options that vary in price, dependent on the delivery method chosen. Delivery options may include mobile tickets, print-at-home, US mail or UPS.	Yes	Per Order	“reason”: “delivery”, “type”: “fee”

All-in Pricing

All-in pricing will be indicated in the Discovery API and Partner API for certain Ticketmaster or Live Nation events that require enforcement of all-in pricing. All-in pricing is set at the event-level.

All Partners:

In the Discovery API, there is an allInclusivePricing field for events. If set to true, then all-in pricing is being applied to that event.

Channel Partners:

In the Availability API Event Inventory and Seat Availability responses, there is an allInclusivePricing field to indicate if all-in pricing is being applied to that event.
Partners can see an event’s all-in pricing status from either Discovery API or Availability API responses.

Open Inventory Affiliate Partners:

In the Top Picks API, there is an allInclusivePricing field in the eventDetails object. If set to true, then all-in pricing is being applied to that event.
In order to match Ticketmaster.com’s all-in pricing experience, we have also made various changes to the fees in the API so that it is easier for you to display this in your own UI.
Under the offers object in Top Picks, if all-in pricing is true:
- TotalPrice: should be the sum of faceValue + any fees programmed on the event. Order Processing Fee will not be included in the calculation of this value.
- Facility fee: will no longer appear in the charges array and will be automatically rolled into the service fee.
- Taxes will no longer appear in the charges array in Top Picks; in line with the Ticketmaster.com experience, these should be shown to the user at checkout.
- For Live Nation owned and operated venues or select Ticketmaster all-in pricing events (eg. if the event is using all-in pricing but not at the state mandated level), the order processing fee will always be $0.
In Partner API Reserve endpoint, if all-in pricing is true, these changes are made to the charges array:
- Service fee: Value is now the sum of all service and facility fees. Service fee does not include tax.
- Tax: Value is now the sum of all taxes for a ticket: service_tax, service_tax_2, face_value_tax
- Facility fee: Now suppressed from the charges array.
- Note: All-in pricing totals can still be retrieved from the totals object in the cart.

Canada All-in Pricing Considerations

Your implementation for all-in pricing in Canada may differ from US all-in pricing event implementation.
In the Canadian market, all-in pricing applies to all events in this country and the all-in pricing field (allInclusivePricing) will NOT be set to true, even though Canada utilizes all-in pricing. Partners should not key off this field to determine if all-in pricing is used.
This field applies only to US events and will always be listed as false for Canadian events in Discovery, Top Picks and Availability APIs.
Canadian all-in pricing is composed of:
- In Top Picks API, all-in pricing functions as it does for the US (e.g. the service fee is combined with facility fee into a single “service fee” line and totalPrice excludes tax)
- In Reserve, unlike the all-in pricing implementation in the US, there are no changes for Canadian all-in pricing. The Reserve response is the same structure as US and CA events when all-in pricing is not enabled (see here for Reserve details). This is to mimic Ticketmaster.com in Canada where Checkout does NOT roll up the facility fee into the service fee.
- In the Availability API, there are no changes for Canadian all-in pricing. The Availability API returns the same response as US and CA events when all-in pricing is not enabled.

Market-level signals for all-in pricing:

Discovery, Top Picks and Availability APIs will also support state-level or market-level required mandates for all-in pricing.
The following US states with all-in pricing legislation will have the allInclusivePricing field set to true given their respective mandate:
- California: Live
- Colorado: Live August 7, 2024
- Connecticut: Live
- Maryland: Live
- Minnesota: Live January 1, 2025
- New York: Live
- North Carolina: Live January 1, 2025
- Tennessee: Live
For other countries, the allInclusivePricing field will always be set to false and should not be used as an indicator that all-in pricing applies to this market. Other countries that mandate all-in pricing and are supported in our API:
- Canada: Live on all events

API Launch Guide

Channel Partners

Service	Description
Event Discovery	Discovery API (search for events, venues, attractions)
	Event Inventory API (Discover events available to transact on)
Seat Inventory	Availability API (pricing and allocated seat inventory per offer)
Purchase	Reserve Tickets (reserve specified tickets)
	Shipping Options (select delivery method)
	Payments (Invoice)
Ticket Delivery	Order Management API (partner receives order/barcode and delivers the ticket to the fan)

Sample Workflow

Call Event Inventory to retrieve the list of events that can be sold

https://app.ticketmaster.com/partners/v1/events?apikey={api_key}
Call Discovery API to get the details of an event

https://app.ticketmaster.com/discovery/v2/events/1AeZZfEGkD0xtGV.json?apikey={api_key}
Call Availability to get the ticket types, prices and seats that you can sell for the event

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/availability?apikey={api_key}

Call Partner API to create Cart

         {
          "reserve" : {
     
         "tickets":[
             {
                 "id": "000002040006",
                 "quantity": 1,
     
                 "price" : {"id" : 3  }
             }
         ]                                                   
         "areas" : [ { "id" : 2 } ],                                                 
         "section": "CLB239",
         "row": "C",
         "begin_seat": 17,
         "end_seat" : 18,
        "accept_best_available": false
          }
          }

Call the shipping endpoint to get the shipping options available for the event

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart/shipping?apikey={api_key}&cart_id={Cart Id from the response in step 4}
Choose and add the shipping option

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart/shipping?apikey={api_key}&cart_ id={Cart Id from the response in step 4}
```
     {"shipping_id": "shipping_id"}  // This value is picked up from the response in step 5 
```

Add the payment information to the cart along with the Customer Information

     {
     "cart_id": "cart_id created in step 4",
       "payment": {
           "address": {
           "city": "Los Angeles",
           "country": {
           "code": "US"
           },
            "line1": "123 Main Street",
             "line2": "",
              "postal_code": "90210",
              "region": {
              "abbrev": "CA"
              }
            },
          "amount": "177.45",
          "email_address": "dc-eng@ticketmaster.com",
          "first_name": "John",
          "home_phone": "212-867-5309",
          "last_name": "Doe",
          "reference": "15278303", //Required for type=INVOICE only. The value should be a positive integer 16 characters long.
          "type": "INVOICE"
      }  

Commit the cart

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart?apikey={api_key}
```
    { 
        "cart_id" : " cart_id created in step 4 "
    } 
```
Ticket Delivery : Order Management returns the detailed order information for ticket delivery, including TM order number and barcode ID

https://app.ticketmaster.com/partners/v1/orders?order_token={order_token received in step 9}&apikey={api_key}

Polling - Some requests may return a polling response when the Ticketmaster system is under heavy load, so you will need to design your system to handle polling requests’)

Open Inventory Partners

Native API Integrations

Service	Description
Event Discovery	Discovery Feed (same as Discovery API content but in a download formats)
Seat Inventory	Top Picks API (seat recommendations based on availability and pricing)
	Inventory Status API (event-level ticket availability signal)
Purchase	Reserve Tickets (reserve specified tickets)
	Shipping Options (select delivery method)
	Payments (payment tokens for credit cards)
Ticket Delivery	Ticketmaster claim process (fans receive tickets via Ticketmaster claim E-mail)

Sample Workflow

Call Discovery API (or Discovery Feed) to retrieve events that can be sold

https://app.ticketmaster.com/discovery-feed/v2/events?apikey={api_key}

This API response will give you links to download the complete list of events for a country in CSV,XML and JSON format. Once you have the list of events you can pick the event id you want to transact on.

Call Discovery API to get the details of an event

https://app.ticketmaster.com/discovery/v2/events/1AeZZfEGkD0xtGV.json?apikey={api_key}
Call Top Picks to get seat recommendations based on availability, pricing and ticket type ids for cart creation

https://app.ticketmaster.com/top-picks/v1/events/1AeZZfEGkD0xtGV?apikey={api_key}

Call Partner API to create Cart

{
  "reserve" : {
  
      "tickets":[
          {
              "id": "000002040006",
              "quantity": 1,
  
              "price" : {"id" : 3  }
          }
      ]                                                   
      "areas" : [ { "id" : 2 } ],                                                 
      "section": "CLB239",
      "row": "C",
      "begin_seat": 17,
      "end_seat" : 18,
     "accept_best_available": false
  }
 }   

Call the shipping endpoint to get the shipping options available for the event

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart/shipping?apikey={api_key}&cart_id={Cart Id from the response in step 4}
Choose and add the shipping option

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart/shipping?apikey={api_key}&cart_ id={Cart Id from the response in step 4}
```
     {"shipping_id": "shipping_id"}  // This value is picked up from the response in step 5 
```
Use Braintree Client SDK to generate the payment token

https://developer.ticketmaster.com/products-and-docs/apis/partner/billing/#braintree-token

You will need a real CC to use in the production environment. Please follow the documentation above as to how to integrate with the Braintree SDK and generate a payment token

Add the payment information to the cart along with the Customer Information

Once you get the payment token please add the payment to your Cart

        {
          "cart_id":"cart_id created in step 4",
          "payment":{
             "address":{
                "city":"",
                "country":{
                   "code":"US"
                },
                "line1":"123 Main Street",
                "line2":"",
                "postal_code":"",
                "region":{
                   "abbrev":"CA"
                }
             },
             "amount":"69.00",
             "card":{
                "number":"braintree-token",
                "expireMonth":12,
                "expireYear":2024,
                "Issuer":"VISA"
             },
             "email_address":"jdoe@ticketmaster.com",
             "first_name":"John",
             "last_name":"Doe",
             "home_phone":"212-867-5309",
             "type":"BRAINTREE"
          }
       }

Commit the cart

https://app.ticketmaster.com/partners/v1/events/1AeZZfEGkD0xtGV/cart?apikey=lBpFEb6wtX2hQywjmPvvkzLOGfU0VKKk
```
     { 
         "cart_id" : " cart_id created in step 4 "
     }   
```
Ticket Delivery: Ticketmaster claim E-mail

Polling - Some requests may return a polling response when the Ticketmaster system is under heavy load, so you will need to design your system to handle polling requests’)

Link-Over API Integrations

Service	Description
Event Discovery	Discovery API (search for events, venues, attractions)
	Discovery Feed (same as Discovery API content but in a download formats)

*Once you have an affiliate publisher ID, you will wrap destination URLs in an Impact Radius wrapper to ensure proper tracking and receive credit for the purchase.

Onboarding Process

Impact Radius is a third-party provider who manages our tracking, reporting and payments. Once authorized, you will be provided the information you need to create an account. Please  reach out to us  about whether you’re appropriate for the program!

For more details about our Affiliate program, please click here.

Distributed Commerce Partner Certification Checklist

Arrange a meeting to walk through your purchase flow with the Distributed Commerce team.
Ensure that you can make all applicable calls for your use case to the Partner API successfully
Ensure that you have considered the Partner API Best Practices below.
Place five test orders on a test event or live event (live events require client/TM approval) and send the Host order numbers to partnersupport@ticketmaster.com for verification. After the orders have been placed, submit a sample monthly settlement report to verify the report is formatted properly with the correct test orders.
After the orders have been verified, the Distributed Commerce team will request refunds as needed.
Submit another sample monthly settlement report with the canceled orders to verify the orders appear in the report.

Partner API Best Practices

FAQs can be found here

Price level ID is not being used in the Availability for mapping inventory and pricing data in your system. This value is not static.
Polling has been implemented.
Nightly Maintenance Windows have been considered. Systems go into nightly maintenance from 2am-4am local time for the event. For example, if a fan is trying to buy an event for NY between 2am-4am EST, the system will be down for maintenance.
Seat Selection: We do not recommend providing a specific seat selection experience similar to ticketmaster.com - this is to avoid high occurrence of no inventory found errors.
- Unless the inventory is exclusive, the seats may not be available (a fan in another channel may be shopping those same seats).
- Instead of specific seat selection, we suggest providing a list view similar view to ticketmaster.com and offer section and rows.
Review common error responses here and determine how best to surface errors to your customers.
If you intend to use images from the Discovery API, most images for events/artists are landscape format, so you may need to consider how to render that in your UI.
If you are using the claims process, ensure that the claim link is appearing in the relevant places in your UI and/or confirmation email.
When adding payment information, update the field called “dc_extra_notes,” with the order number that a fan will receive from you when their order is confirmed. This is to help the box offices troubleshoot issues when fans provide a partner’s order number. Please see the documentation here.

APIs

SDKs

Ignite

Legacy SDKs

TUTORIALS

FAQ

General Terms of Use

Partner API Terms of Use

Partner API Faq

Contact Us

API status

Products & Docs

APIs

SDKs

Tutorials

Partner API

Release Notes

Overview

Authentication

Host and API endpoint information

Production environment testing

Universal Ids

Best Practices

Cleanup

Polling

Terms and Conditions

Service Availability

Support/FAQs

Contact

Event Click Tracking Url [GET]

Parameters

Event Information

Reserve tickets and create a Cart [POST]

Parameters

Response structure:

Response structure for Resale Cart

Response structure for All-in Pricing Cart

Shipping Options [GET]

Parameters

Shipping Options [PUT]

Parameters

Response structure:

Add Billing Information [PUT]

Parameters

Payment Tokenization

This request is used to add a Braintree token as payment method to the cart.

This request is used to add a invoice payment method to the cart.

Commit Cart [PUT]

Parameters

Properties

Response structure:

Redemption Email

Delete Cart [DELETE]

Parameters

Polling [GET]

Parameters

Order management [GET]

Parameters

Response Sample for Host orders

NOTES:

Response Sample for MFX orders

Response Sample for Universe orders

Mobile Ticket Display Requirements

Unredeemed orders [GET]

Parameters

Order Redemption Status [GET]

Parameters

Refund orders [POST]

Parameters

Error Responses

Error Responses

Cart

Cart Item - Tickets

Cart Item - Delivery

Cart Item - Processing

Payment Section - This section is added to Cart Response after adding billing

Payment Request

Wallet Token Payment (Wallet anonymous)

Member Id Payment (Wallet)

Order Response Structure