Partner API

The Ticketmaster Partner API lets clients reserve, purchase, and retreive ticket and event informaton. The Ticketmaster Partner API is not an Open API and is restricted to official Distributed Commerce business partners.

Make live API calls right now in the interactive docs:

INTERACTIVE DOCS

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

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.

Authorization

Any API calls which require member authorization, refer to Ticketmaster OAuth API on how to get the Member Access Token and maintaining them. For all the Member Authorization requests, you will have to pass the following header with the request Authorization: Bearer <access_token>.

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

Request Response

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.

  1. Ability to reserve non-adjacent seats.
  2. Ability to reserve seats in difference price levels.
  3. 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

Request Response

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
  }
}

Shipping Options [GET]

Get shipping options available for this event. Note: some API users will be pre-configured for certain shipping options and may not need to perform this.

Specifying the “region” query parameter will return options available for users in the selected country. Using the value ‘ALL’ will return all options.

/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. It is an optional parameter and not sending a region value will give the US options. string “CA” No

Request Response

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

Request Response

    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
      }
    }

Generate Wallet Token for Accountless Payment [POST] (deprecated)

The ticketmaster payment service will allow partners to add credit card for anonymous user.It adds credit card data to an anonymous wallet.

https://payment.ticketmaster.com/wallet/v1/token?apiKey={apikey}

Request Response

https://payment.ticketmaster.com/wallet/v1/token?apiKey=GkB8Z037ZfqbLCNtZViAgrEegbsrZ6Ne

{
   "flow_attributes" : {
       "channel" : "external.ecommerce.consumer.dc.ticketmaster.us",
       "market" : "PRIMARY"  // This could be "PRIMARY" or "RESALE".
      },
   "funding_source_details" : {
       "account_number" : "4588883206000011",
       "expiration_month" : 12,
       "expiration_year" : 2020,
       "billing_address" : {
		"first_name" : "Joe",
		"last_name" : "Brown",
		"address_line1" : "7060 Hollywood Blvd",
		"address_line2" : "suite 202",
		"city" : "Hollywood",
		"state" : "CA",
		"country" : "US",
		"postal_code" : "91344",
		"mobile_phone" : "3104458988",
		"email" : "rc@tm.com"
			 } },
   "funding_source" : "creditcard"
}
Status 200

{
  "token": "wallet-wallet-0eb60d8aa4994bc8a6aa6aa4b330f996",
  "validated": false,
  "billing_address": {
    "city": "Hollywood",
    "state": "CA",
    "country": "US",
    "email": "rc@tm.com",
    "first_name": "Joe",
    "last_name": "Brown",
    "address_line1": "7060 Hollywood Blvd",
    "address_line2": "suite 202",
    "postal_code": "91344",
    "mobile_phone": "3104458988"
    },
  "funding_method": "VISA",
  "funding_source": "creditcard",
  "expiration_month": 12,
  "expiration_year": 2020
  }
  

The wallet token “wallet-wallet-0eb60d8aa4994bc8a6aa6aa4b330f996” returned can then be used to add payment in the Partner API using the add billing endpoint. The wallet token will be passed as card number along with the cin. The token and the cin need not be encrypted in this case.

Add Billing Information [PUT]

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

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

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

Request Response

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
 	"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 wallet token as payment method to the cart. (DEPRECATED)

Request Response

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 http://www.nationsonline.org/oneworld/country_code_list.htm
      "line1": "123 Main Street",
      "line2": "",
      "postal_code": "",
      "region": {"abbrev":"CA"}
    },
    "amount": "69.00",
    "card": {
      "cin": "123",
      "number": "wallet-wallet-442d8c3e20194dc5a34c7a9b8b8dd662"
},
    "email_address":"pracheta.gupta@ticketmaster.com", //Max length : 128 characters
    "first_name": "John", //Max length : 50 characters
    "home_phone": "212-867-5309",
    "last_name": "Doe", //Max length : 50 characters
    "type": "WALLET"
  }
}
Status 200
{
    "cart" : {
        ...
    }
}

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

Polling: No
Authorization: Required

Request Response

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"
      },
       "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
     "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

Request Response

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"
    }
    "attribute_overrides": { //Optional , to override the images for redemption and email. Contact Ticketmaster for access to override attributes.

      "images": {
        "email_1x": "http://s1.ticketm.net/dam/c/MUSIC_TABLET_LANDSCAPE_LARGE_16_9.jpg",
        "1x": "http://s1.ticketm.net/dam/c/MUSIC_TABLET_LANDSCAPE_LARGE_16_9.jpg",
        "web_1x": "http://s1.ticketm.net/dam/c/MUSIC_TABLET_LANDSCAPE_LARGE_16_9.jpg"
      }
    }
}
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}

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

Request Response

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

Request Response

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}&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

Request Response

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",
            "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
}

Unredeemed orders [GET]

Retreive 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

Request Response

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

        }
    ]
}

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)

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

  1. Call Event Inventory to retrieve the list of events that can be sold
  2. Call Get Event Details to retrieve event meta data and display the event listing
  3. Call Availability to get the ticket types, prices and seats that you can sell for the event
  4. Purchase:
    • Checkout - allows you to reserve tickets, select shipping, add payment and commit orders
    • Payment - Use the Invoice payment method for orders
    • 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’)
  5. Ticket Delivery: Order Management returns the detailed order information for ticket delivery, including TM order number and barcode ID

Affiliate Partners

Native 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)
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

  1. Call Discovery API (or Discovery Feed) to retrieve events that can be sold
  2. Call Top Picks to get seat recommendations based on availability and pricing
  3. Purchase:
    • Checkout - allows you to reserve tickets, select shipping, add payment and commit orders
    • 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’)
  4. Ticket Delivery: Ticketmaster claim E-mail

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.