TM 3RD PARTY INTEGRATION API

V 0.20.0

This is the first version of the 3rd Party Integration API specification for Ticketmaster Partners which will be available in our EU markets starting in late 2020. Through this API, Partners can provide allocations to the Ticketmaster ticketing platform in order to sell their inventory through the broad reach of Ticketmaster sales channels.

Event

A public entertainment pending to take place

get /events Get an event list from the Partner system
get /events/{event_id} Get an event from the Partner system
get /events/{event_id}/availability Get the event availability from the Partner system.

Manifest

A seat configuration associated to an event

get /manifests/{manifest_id} Get a manifest from the Partner system

Booking

An amount of tickets reserved in order to buy them

post /bookings Create a reservation in the Partner ticketing system
delete /bookings/{inventory_token} Release a reservation in the Partner system

Order

An amount of tickets purchased

get /orders Get an list of order information from the Partner system
post /orders Create an order in the Partner ticketing system
get /orders/{inventory_order} Get the order status from the Partner system
post /orders/{inventory_order} Update an order to print, to rollback the print or to cancel

Default

get /healthcheck Testing for the reachability of a Partner system and retrieve notifications

Health Check Request

Method: GET

Summary: Health Check Request

Description: Testing for the reachability of a Partner system and retrieve notifications

/healthcheck

Response structure:

200 Successful operation

  • id(integer) - 0 - Successful 901 - Service not currently available 902 - Syncronization required
  • message(string) - No description specified
  • venues_to_sync(array) - No description specified
    • [ "string" ]

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

500 Internal error

Authorization:

3p_auth: check:3p-system

Examples:

Successful sync

Request Response

GET /healhtcheck HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "id": 0,
  "message": "Successful"
}

Synchronization required

Request Response

GET /healhtcheck HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "id": 902,
  "message": "Synchronization required",
  "venues_to_sync": ["venue1", "venue2"]
}

Retrieves a list of events

Method: GET

Summary: Retrieves a list of events

Description: Get an event list from the Partner system

/events

Query parameters:

Parameter Description Type Default Value Required
venue Venue where the event take place String Yes
last_modification Minimum last modification (UTC date and time) String Yes
size Page size of the response Integer 20 No
page Page number Integer 1 No
sort Sorting order of the search result. Allowable values - "NAME,DATE" or "DATE,NAME" (no letter casing) String enum:["name,date", "date,name"] DATE,NAME No

Response structure:

200 Successful operation

  • events_info(array) - No description specified
    • { array item object }
      • event(object)
        • event_id(string) - Event identifier
        • last_modification(string) - UTC date and time of the event last modification
        • organization_info(object)
          • promoter_id(string) - Promoter identifier (tax identification number)
          • promoter_name(string) - Promoter name
        • manifest_id(string) - Manifest identifier
        • text_infos(array)
          • {array item object}
            • lang(string) - ISO language and country codes (Example "es-es").
            • name(string) - Event name or title
            • description(string) - Event description
        • maximum_tickets_quantity(integer) - Global maximum number of tickets
        • genre_info(array)
          • {array item object}
            • genre_id(string) - Event genre identifier
            • genre_name(string) - Event genre name
        • date_time(string) - Event UTC date and time
        • date_time_properties(object)
          • date_hidden(boolean) - True if the event date can't be showed
          • time_hidden(boolean) - True if the event time can't be showed
        • visibility(object)
          • default_visibility(string: enum) - Visibility of the event in TM sales channels at the event creation (no letter casing) "VISIBLE" - the event is published in the sales channels "NOT_VISIBLE" - the event is not published in the sales channels and it isn't operational "HIDDEN" - the event is not published on the sales channels but it's operational
            • VISIBLE
            • NOT_VISIBLE
            • HIDDEN
          • visibility_override
            • visibility(string: enum) - Visibility of the event in TM sales channels at a specific date/time (no letter casing) "VISIBLE" - the event is published in the sales channels "NOT_VISIBLE" - the event is not published in the sales channels and it isn't operational "HIDDEN" - the event is not published on the sales channels but it's operational
              • VISIBLE
              • NOT_VISIBLE
              • HIDDEN
            • starts_on(string) - Specific UTC date/time of the visibility change
        • doors_date_time(string) - Doors UTC date time
        • doors_date_time_properties(object)
          • date_hidden(boolean) - True if the doors date can't be showed
          • time_hidden(boolean) - True if the doors time can't be showed
        • price_levels(array) - list of price categories
          • {array item object}
            • id(string) - Price level identifier
            • text_infos(array)
              • {array item object}
                • lang(string) - ISO language and country codes (Example "es-es").
                • name(string) - Price level name
                • description(string) - Price level description
        • price_types(array) - list of price types
          • {array item object}
            • id(string) - Price type identifier
            • regular(boolean) - Indicates if this price type is the "regular" price. Can have only one price type set to true.
            • access_code(string) - password to access this price type
            • text_infos(array)
              • {array item object}
                • lang(string) - ISO language and country codes (Example "es-es").
                • name(string) - Price type name
                • description(string) - Price type description
                • additional_info(string) - Price type additional info
                • printed_description(string) - Price type printed description
        • face_value_prices(array) - list of prices
          • {array item object}
            • price_period
              • id(string) - Period id
              • start_date_time(string) - Period start date and time (UTC date and time, the seconds will be discarded)
              • end_date_time(string) - Period end date and time (UTC date and time, the seconds will be discarded)
            • prices(array)
              • {array item object}
                • price_level_id(string) - Price level identifier
                • price_type_id(string) - Price type identifier
                • amount(string) - Price for these price level and price type (Minor currency units ex. 2000 = 20EUR)
      • status(string: enum) - Event status (no letter casing)
        • ON_SALE
        • CANCELED
        • DELETED
  • page(object) - No description specified
    • size(integer) - size of page
    • total_elements(integer) - total number of available elements
    • total_pages(integer) - total number of available pages
    • number(integer) - current page number counted from 1

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: ingestion:3p-system

Examples:

Retrieve events of "000001" venue since "July 19th at 14:00"

Request Response

GET /events?venue=000001&last_modification=2019-07-19T14:00:44Z&size=10&page=1 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "events_info":[
    {
      "event":{
        "event_id":"000001003000007",
        "last_modification":"2019-07-31T09:38:21Z",
        "organization_info":{
          "promoter_id":"00000001 R",
          "promoter_name":"EMPRESA PATROCINADORA"
        },
        "manifest_id":"000001003",
        "text_infos":[
          {
            "lang":"es-es",
            "name":"Festival Flamenco on Fire 2019 Sara Baras",
            "description":"Prohibido Menores 16 Años\r\n"
          }
        ],
        "maximum_tickets_quantity":6,
        "genre_info":[
          {
            "genre_id":"009",
            "genre_name":"MUSICAL"
          }
        ],
        "date_time":"2019-09-15T19:00:00Z",
        "visibility":{
          "default_visibility":"VISIBLE"
        },
        "price_levels":[
          {
            "id":"011 01",
            "text_infos":[
              {
                "lang":"es-es",
                "name":"011 01",
                "description":"GRADA A"
              }
            ]
          },
          {
            "id":"011 02",
            "text_infos":[
              {
                "lang":"es-es",
                "name":"011 02",
                "description":"GRADA A Minusvàlids"
              }
            ]
          },
          {
            "id":"012 01",
            "text_infos":[
              {
                "lang":"es-es",
                "name":"012 01",
                "description":"GRADA B"
              }
            ]
          },
          {
            "id":"013 01",
            "text_infos":[
              {
                "lang":"es-es",
                "name":"013 01",
                "description":"GRADA C"
              }
            ]
          },
          {
            "id":"014 01",
            "text_infos":[
              {
                "lang":"es-es",
                "name":"014 01",
                "description":"GRADA D"
              }
            ]
          }
        ],
        "price_types":[
          {
            "id":"0000000",
            "regular":true,
            "text_infos":[
              {
                "lang":"es-es",
                "name":"TARIFA GEN",
                "description":"TARIFA GENERAL",
                "printed_description":"TARIFA GENERAL"
              }
            ]
          },
          {
            "id":"0001000",
            "regular":false,
            "text_infos":[
              {
                "lang":"es-es",
                "name":"DESCUENTO ",
                "description":"DESCUENTO 10%",
                "printed_description":"DESCUENTO 10%"
              }
            ]
          }
        ],
        "face_value_prices":[
          {
            "price_period":{
              "id":"Periodo de venta",
              "start_date_time":"2019-05-27T22:00:00Z",
              "end_date_time":"2019-09-15T19:00:00Z"
            },
            "prices":[
              {
                "price_level_id":"011 01",
                "price_type_id":"0000000",
                "amount":"1500"
              },
              {
                "price_level_id":"011 01",
                "price_type_id":"0001000",
                "amount":"1350"
              },
              {
                "price_level_id":"011 02",
                "price_type_id":"0000000",
                "amount":"1500"
              },
              {
                "price_level_id":"011 02",
                "price_type_id":"0001000",
                "amount":"1350"
              },
              {
                "price_level_id":"012 01",
                "price_type_id":"0000000",
                "amount":"1500"
              },
              {
                "price_level_id":"012 01",
                "price_type_id":"0001000",
                "amount":"1350"
              },
              {
                "price_level_id":"013 01",
                "price_type_id":"0000000",
                "amount":"1500"
              },
              {
                "price_level_id":"013 01",
                "price_type_id":"0001000",
                "amount":"1350"
              },
              {
                "price_level_id":"014 01",
                "price_type_id":"0000000",
                "amount":"1500"
              },
              {
                "price_level_id":"014 01",
                "price_type_id":"0001000",
                "amount":"1350"
              }
            ]
          }
        ]
      },
      "status":"ON_SALE"
    }
  ],
  "page":{
    "size":1,
    "total_elements":1,
    "total_pages":1,
    "number":1
  }
}

Retrieves a specific event.

Method: GET

Summary: Retrieves a specific event.

Description: Get an event from the Partner system

/events/{event_id}

URL parameters:

Parameter Description Type Default Value Required
event_id Event identifier String Yes

Query parameters:

Parameter Description Type Default Value Required
last_modification Minimum last modification (UTC date and time) String Yes

Response structure:

200 Successful operation

  • event(object) - No description specified
    • event_id(string) - Event identifier
    • last_modification(string) - UTC date and time of the event last modification
    • organization_info(object)
      • promoter_id(string) - Promoter identifier (tax identification number)
      • promoter_name(string) - Promoter name
    • manifest_id(string) - Manifest identifier
    • text_infos(array)
      • {array item object}
        • lang(string) - ISO language and country codes (Example "es-es").
        • name(string) - Event name or title
        • description(string) - Event description
    • maximum_tickets_quantity(integer) - Global maximum number of tickets
    • genre_info(array)
      • {array item object}
        • genre_id(string) - Event genre identifier
        • genre_name(string) - Event genre name
    • date_time(string) - Event UTC date and time
    • date_time_properties(object)
      • date_hidden(boolean) - True if the event date can't be showed
      • time_hidden(boolean) - True if the event time can't be showed
    • visibility(object)
      • default_visibility(string: enum) - Visibility of the event in TM sales channels at the event creation (no letter casing) "VISIBLE" - the event is published in the sales channels "NOT_VISIBLE" - the event is not published in the sales channels and it isn't operational "HIDDEN" - the event is not published on the sales channels but it's operational
        • VISIBLE
        • NOT_VISIBLE
        • HIDDEN
      • visibility_override
        • visibility(string: enum) - Visibility of the event in TM sales channels at a specific date/time (no letter casing) "VISIBLE" - the event is published in the sales channels "NOT_VISIBLE" - the event is not published in the sales channels and it isn't operational "HIDDEN" - the event is not published on the sales channels but it's operational
          • VISIBLE
          • NOT_VISIBLE
          • HIDDEN
        • starts_on(string) - Specific UTC date/time of the visibility change
    • doors_date_time(string) - Doors UTC date time
    • doors_date_time_properties(object)
      • date_hidden(boolean) - True if the doors date can't be showed
      • time_hidden(boolean) - True if the doors time can't be showed
    • price_levels(array) - list of price categories
      • {array item object}
        • id(string) - Price level identifier
        • text_infos(array)
          • {array item object}
            • lang(string) - ISO language and country codes (Example "es-es").
            • name(string) - Price level name
            • description(string) - Price level description
    • price_types(array) - list of price types
      • {array item object}
        • id(string) - Price type identifier
        • regular(boolean) - Indicates if this price type is the "regular" price. Can have only one price type set to true.
        • access_code(string) - password to access this price type
        • text_infos(array)
          • {array item object}
            • lang(string) - ISO language and country codes (Example "es-es").
            • name(string) - Price type name
            • description(string) - Price type description
            • additional_info(string) - Price type additional info
            • printed_description(string) - Price type printed description
    • face_value_prices(array) - list of prices
      • {array item object}
        • price_period
          • id(string) - Period id
          • start_date_time(string) - Period start date and time (UTC date and time, the seconds will be discarded)
          • end_date_time(string) - Period end date and time (UTC date and time, the seconds will be discarded)
        • prices(array)
          • {array item object}
            • price_level_id(string) - Price level identifier
            • price_type_id(string) - Price type identifier
            • amount(string) - Price for these price level and price type (Minor currency units ex. 2000 = 20EUR)
  • status(string) - Event status (no letter casing)

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

404 Not found (the event has not been found)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: ingestion:3p-system

Examples:

Update information of "000002002000006" event

Request Response

GET /events/000002002000006?last_modification=2019-02-19T14:00:44Z HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "event":{
    "event_id":"000002002000006",
    "last_modification":"2019-07-29T06:14:31Z",
    "organization_info":{
      "promoter_id":"00000003 A",
      "promoter_name":"CAMBIO PROMOTOR"
    },
    "manifest_id":"000002002",
    "text_infos":[
      {
        "lang":"es-es",
        "name":"Anthrax - Testament 4",
        "description":"Prohibido Menores 16 Años\r\nAnthrax es una banda estadounidense de thrash metal, formada en Nueva York en 1981. 4"
      }
    ],
    "maximum_tickets_quantity":6,
    "genre_info":[
      {
        "genre_id":"012",
        "genre_name":"CONCIERTO"
      }
    ],
    "date_time":"2019-10-10T18:00:00Z",
    "visibility":{
      "default_visibility":"VISIBLE"
    },
    "price_levels":[
      {
        "id":"011 01",
        "text_infos":[
          {
            "lang":"es-es",
            "name":"011 01",
            "description":"GRADA A"
          }
        ]
      },
      {
        "id":"011 02",
        "text_infos":[
          {
            "lang":"es-es",
            "name":"011 02",
            "description":"GRADA A Minusvàlids"
          }
        ]
      },
      {
        "id":"012 01",
        "text_infos":[
          {
            "lang":"es-es",
            "name":"012 01",
            "description":"GRADA B"
          }
        ]
      },
      {
        "id":"013 01",
        "text_infos":[
          {
            "lang":"es-es",
            "name":"013 01",
            "description":"GRADA C"
          }
        ]
      },
      {
        "id":"014 01",
        "text_infos":[
          {
            "lang":"es-es",
            "name":"014 01",
            "description":"GRADA D"
          }
        ]
      }
    ],
    "price_types":[
      {
        "id":"0003000",
        "regular":true,
        "text_infos":[
          {
            "lang":"es-es",
            "name":"TARIFA GEN",
            "description":"TARIFA GENERAL",
            "printed_description":"TARIFA GENERAL"
          }
        ]
      },
      {
        "id":"0004000",
        "regular":false,
        "text_infos":[
          {
            "lang":"es-es",
            "name":"DESCUENTO ",
            "description":"DESCUENTO 5%",
            "printed_description":"DESCUENTO 5%"
          }
        ]
      }
    ],
    "face_value_prices":[
      {
        "price_period":{
          "id":"Periodo de venta",
          "start_date_time":"2019-07-12T08:00:00Z",
          "end_date_time":"2019-10-10T18:00:00Z"
        },
        "prices":[
          {
            "price_level_id":"011 01",
            "price_type_id":"0003000",
            "amount":"2000"
          },
          {
            "price_level_id":"011 01",
            "price_type_id":"0004000",
            "amount":"1900"
          },
          {
            "price_level_id":"011 02",
            "price_type_id":"0003000",
            "amount":"2000"
          },
          {
            "price_level_id":"011 02",
            "price_type_id":"0004000",
            "amount":"1900"
          },
          {
            "price_level_id":"012 01",
            "price_type_id":"0003000",
            "amount":"2200"
          },
          {
            "price_level_id":"012 01",
            "price_type_id":"0004000",
            "amount":"2090"
          },
          {
            "price_level_id":"013 01",
            "price_type_id":"0003000",
            "amount":"2500"
          },
          {
            "price_level_id":"013 01",
            "price_type_id":"0004000",
            "amount":"2375"
          },
          {
            "price_level_id":"014 01",
            "price_type_id":"0003000",
            "amount":"2200"
          },
          {
            "price_level_id":"014 01",
            "price_type_id":"0004000",
            "amount":"2090"
          }
        ]
      }
    ]
  },
  "status":"ON_SALE"
}

Retrieves the availability of an event.

Method: GET

Summary: Retrieves the availability of an event.

Description: Get the event availability from the Partner system.

/events/{event_id}/availability

URL parameters:

Parameter Description Type Default Value Required
event_id Event identifier String Yes

Query parameters:

Parameter Description Type Default Value Required
last_modification UTC date and time of the event last modification String Yes
level Level identifier or 'ALL' String ALL No
section Section identifier or 'ALL' String ALL No
avail_level Level of information detail (no letter casing) "OVERVIEW" retrieves only quantities object (no rows) "DETAIL" retrieves quantities and rows objects String enum:["overview", "detail"] OVERVIEW No

Response structure:

200 Successful operation

  • venue_id(string) - Venue associated to the event
  • manifest_id(string) - Manifest identifier
  • ga_areas(array) - No description specified
    • { array item object }
      • level_id(string) - Level id
      • section_id(string) - Section id
      • price_level_id(string) - Price level or price category for all seats of the area
      • quantities(object)
        • available(integer) - Number of available seats in the area
        • unavailable(integer) - Number of unavailable seats in the area
  • rs_areas(array) - No description specified
    • { array item object }
      • level_id(string) - Level id
      • section_id(string) - Section id
      • quantities(object)
        • available(integer) - Number of available seats in the area
        • unavailable(integer) - Number of unavailable seats in the area
      • rows(array)
        • {array item object}
          • row(string) - row label
          • seats
            • available(array)
              • [ "string" ] - seat label

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

404 Not found (the event has not been found)

409 Conflict (invalid last_modification)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: ingestion:3p-system

Examples:

Retrieve detailed availability information of the event "000002002000007", section "0013 01"

Request Response

GET /events/000002002000007/availability?last_modification=2019-09-12T11:17:19Z&section=001301p&avail_level=detail HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "venue_id":"000002",
  "manifest_id":"000002002",
  "rs_areas":[
    {
      "section_id":"0013 01",
      "quantities":{
        "available":"72",
        "unavailable":"6"
      },
      "rows":[
        {
          "row":"01",
          "seats":{
            "available":[
              "005",
              "010",
              "012"
            ]
          }
        },
        {
          "row":"02",
          "seats":{
            "available":[
              "002",
              "001",
              "014",
              "012",
              "010",
              "003",
              "007",
              "006",
              "005",
              "004",
              "008"
            ]
          }
        }
      ]
    }
  ]
}

Retrieves a specific manifest.

Method: GET

Summary: Retrieves a specific manifest.

Description: Get a manifest from the Partner system

/manifests/{manifest_id}

URL parameters:

Parameter Description Type Default Value Required
manifest_id Manifest identifier String Yes

Response structure:

200 Successful operation

  • manifest_id(string) - Manifest identifier
  • description(string) - Manifest description
  • venue_id(string) - Venue associated to the manifest
  • total_capacity(integer) - Total capacity for the manifest that must match the total number of seats in all areas
  • ga_areas(array) - No description specified
    • { array item object }
      • level_id(string) - Level id
      • section_id(string) - Section id
      • price_level_id(string) - Price level or price category for all seats of the area
      • free_text(string) - Free text to include on tickets, will apply to all seats of the area
      • capacity(integer) - Total capacity for the area
  • rs_areas(array) - No description specified
    • { array item object }
      • level_id(string) - Level id
      • section_id(string) - Section id
      • price_level_id(string) - Default price level or price category for all seats of the area
      • free_text(string) - Default free text to include on tickets, will apply to all seats of the area
      • rows(array)
        • {array item object}
          • row(string) - row label
          • position_y(integer) - Indicates the relative y position of this seat in relation to the other seats of the same area (i.e y position in the area's seat matrix).
          • seats(array)
            • {array item object}
              • seat(string) - seat label
              • killed(boolean) - True if the seat is killed
              • free_text(string) - Free text to include on the ticket of the seat (overwrite rs_area.free_text)
              • position_x(integer) - Indicates the relative x position of this seat in relation to the other seats of the same area (i.e x position in the area's seat matrix).
  • sections(array) - No description specified
    • { array item object }
      • id(string) - Section identifier
      • description(string) - Section description
  • levels(array) - No description specified
    • { array item object }
      • id(string) - Level identifier
      • description(string) - Level description
  • price_levels(array) - No description specified
    • { array item object }
      • id(string) - Price level identifier

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

404 Not found (the manifest has not been found)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: ingestion:3p-system

Examples:

Retrieve information of manifest "000001002"

Request Response

GET /manifests/000001002 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "manifest_id":"000001002",
  "description":"Sala Mixta                              ",
  "venue_id":"000001",
  "total_capacity":496,
  "ga_areas":[
    {
      "level_id":"1",
      "section_id":"1012 01",
      "price_level_id":"012 01",
      "capacity":100
    }
  ],
  "rs_areas":[
    {
      "level_id":"1",
      "section_id":"0011 01",
      "price_level_id":"011 01",
      "rows":[
        {
          "row":"01",
          "position_y":18,
          "seats":[
            {
              "seat":"001",
              "position_x":13
            },
            {
              "seat":"022",
              "position_x":1
            },
            {
              "seat":"003",
              "position_x":14
            },
            {
              "seat":"004",
              "position_x":10
            },
            {
              "seat":"005",
              "position_x":15
            },
            {
              "seat":"006",
              "position_x":9
            }
          ]
        }
      ]
    }
  ],
  "sections":[
    {
      "id":"0011 01",
      "description":"Patio de Butacas"
    },
    {
      "id":"1012 01",
      "description":"Anfiteatro"
    }
  ],
  "levels":[
    {
      "id":"1",
      "description":"Planta 1"
    }
  ],
  "price_levels":[
    {
      "id":"011 01"
    },
    {
      "id":"012 01"
    }
  ]
}

Inventory Request

Method: POST

Summary: Inventory Request

Description: Create a reservation in the Partner ticketing system

/bookings

Other parameters:

Parameter In Description Type Default Value Required
request body Information to create a reservation
InventoryRequest
show all
Yes

Response structure:

200 Successful opertaion (it has been processed but reservation not created).

  • event_id(string) - Partner event id
  • inventory_token(string) - Reservation reference that must be used for Commit or Release
  • inventory_ttl(integer) - Time to live in seconds for this reservation
  • search_results(array) - No description specified
    • { array item object }
      • search_index(integer) - Search index, so responses can be matched with request
      • status(object)
        • id(integer) - 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
        • message(string)
      • non_adjacent(boolean) - True for non adjacent seats
      • alternate(boolean) - True for alternate seats
      • tickets(array)
        • {array item object}
          • price_level_id(string) - Ticket price level id
          • price_type_id(string) - Ticket price type id
          • ticket_id(string) - Ticket id
          • level(string) - Ticket level id
          • section(string) - Ticket section id
          • row(string) - Row for reserved seat ticket. Won't be present for general admission
          • seat(string) - Seat number for reserved seat ticket. Won't be present for general admission

201 Successful operation (the reservation has been successfully created).

  • event_id(string) - Partner event id
  • inventory_token(string) - Reservation reference that must be used for Commit or Release
  • inventory_ttl(integer) - Time to live in seconds for this reservation
  • search_results(array) - No description specified
    • { array item object }
      • search_index(integer) - Search index, so responses can be matched with request
      • status(object)
        • id(integer) - 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
        • message(string)
      • non_adjacent(boolean) - True for non adjacent seats
      • alternate(boolean) - True for alternate seats
      • tickets(array)
        • {array item object}
          • price_level_id(string) - Ticket price level id
          • price_type_id(string) - Ticket price type id
          • ticket_id(string) - Ticket id
          • level(string) - Ticket level id
          • section(string) - Ticket section id
          • row(string) - Row for reserved seat ticket. Won't be present for general admission
          • seat(string) - Seat number for reserved seat ticket. Won't be present for general admission

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

409 Conflict (invalid last_modification)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: runtime:3p-system

Examples:

Booking of 2 general admission tickets (2 adults)

Request Response

POST /bookings HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"es-es",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB regular"
  },
  "event_id":"000001004000004",
  "last_modification":"2019-06-13T12:45:06Z",
  "searches":[
    {
      "index":"1",
      "accept_non_adjacent":false,
      "accept_alternate":[

      ],
      "search_type":"BESTAVAIL",
      "bestavail":{
        "areas":[

        ],
        "price_level_ids":[
          "011 01",
          "012 01"
        ],
        "price_types":[
          {
            "id":"0001000",
            "quantity":"2"
          }
        ]
      }
    }
  ]
}
HTTP/1.1 200 OK

{
  "event_id":"000001004000004",
  "inventory_token":"000001M000000019_19090915583001",
  "inventory_ttl":"570",
  "search_results":[
    {
      "search_index":"1",
      "status":{
        "id":"0",
        "message":"Successful (no error)"
      },
      "non_adjacent":false,
      "alternate":false,
      "tickets":[
        {
          "price_level_id":"011 01",
          "price_type_id":"0001000",
          "ticket_id":"000000",
          "level":"1",
          "section":"1011 01"
        },
        {
          "price_level_id":"011 01",
          "price_type_id":"0001000",
          "ticket_id":"000001",
          "level":"1",
          "section":"1011 01"
        }
      ]
    }
  ]
}

Booking of 3 general admission tickets (2 adults and 1 child)

Request Response

POST /bookings HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"es-es",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB regular"
  },
  "event_id":"000001004000004",
  "last_modification":"2019-06-13T12:45:06Z",
  "searches":[
    {
      "index":"1",
      "accept_non_adjacent":false,
      "accept_alternate":[

      ],
      "search_type":"BESTAVAIL",
      "bestavail":{
        "areas":[

        ],
        "price_level_ids":[
          "011 01",
          "012 01"
        ],
        "price_types":[
          {
            "id":"0001000",
            "quantity":"2"
          },
          {
            "id":"0002000",
            "quantity":"1"
          }
        ]
      }
    }
  ]
}
HTTP/1.1 200 OK

{
  "market":"ES",
  "event_id":"17067",
  "external_inventory_token":"ESBACANT-000001M000000020_19090916075501",
  "external_inventory_ttl":"570",
  "search_results":[
    {
      "status":{
        "id":"0",
        "message":"Successful (no error)"
      },
      "alternate":false,
      "tickets":[
        {
          "price_level_id":"1",
          "price_type_id":"1",
          "ticket_id":"000000",
          "area_id":"1-1"
        },
        {
          "price_level_id":"1",
          "price_type_id":"1",
          "ticket_id":"000001",
          "area_id":"1-1"
        },
        {
          "price_level_id":"1",
          "price_type_id":"2",
          "ticket_id":"000002",
          "area_id":"1-1"
        }
      ],
      "search_index":"1",
      "non_adjacent":false
    }
  ]
}

Booking of 2 specific reserved seat tickets (1 adult and 1 discount), the best available in “0011 01” sector with the possibility of alternative in another area and not contiguous

Request Response

POST /bookings HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"es-es",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB regular"
  },
  "event_id":"000002002000006",
  "last_modification":"2019-07-29T06:14:31Z",
  "searches":[
    {
      "index":"1",
      "accept_non_adjacent":true,
      "accept_alternate":[
        "AREA"
      ],
      "search_type":"SPECIFIC",
      "specific":{
        "tickets":[
          {
            "price_level_id":"011 01",
            "price_type_id":"0003000",
            "section":"0011 01",
            "row":"03",
            "seat":"002"
          },
          {
            "price_level_id":"011 01",
            "price_type_id":"0004000",
            "section":"0011 01",
            "row":"03",
            "seat":"004"
          }
        ]
      }
    }
  ]
}
HTTP/1.1 200 OK

{
  "event_id":"000002002000006",
  "inventory_token":"000002M000000004_19091011113701",
  "inventory_ttl":570,
  "search_results":[
    {
      "search_index":1,
      "non_adjacent":false,
      "alternate":false,
      "status":{
        "id":0,
        "message":"Successful (no error)"
      },
      "tickets":[
        {
          "price_level_id":"011 01",
          "price_type_id":"0003000",
          "ticket_id":"000032",
          "section":"0011 01",
          "row":"03",
          "seat":"002"
        },
        {
          "price_level_id":"011 01",
          "price_type_id":"0004000",
          "ticket_id":"000031",
          "section":"0011 01",
          "row":"03",
          "seat":"004"
        }
      ]
    }
  ]
}

Booking of 2 reserved seat tickets (1 adults and 1 child), specific seats, no alternative

Request Response

POST /bookings HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"es-es",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB regular"
  },
  "event_id":"000002002000006",
  "last_modification":"2019-07-29T06:14:31Z",
  "searches":[
    {
      "index":"1",
      "accept_non_adjacent":false,
      "accept_alternate":[

      ],
      "search_type":"SPECIFIC",
      "specific":{
        "tickets":[
          {
            "price_level_id":"011 01",
            "price_type_id":"0003000",
            "section":"0011 01",
            "row":"03",
            "seat":"006"
          },
          {
            "price_level_id":"011 01",
            "price_type_id":"0004000",
            "section":"0011 01",
            "row":"03",
            "seat":"008"
          }
        ]
      }
    }
  ]
}
HTTP/1.1 200 OK

{
  "event_id":"000002002000006",
  "inventory_token":"000002M000000005_19091011162801",
  "inventory_ttl":570,
  "search_results":[
    {
      "search_index":1,
      "non_adjacent":false,
      "alternate":false,
      "status":{
        "id":0,
        "message":"Successful (no error)"
      },
      "tickets":[
        {
          "price_level_id":"011 01",
          "price_type_id":"0003000",
          "ticket_id":"000030",
          "section":"0011 01",
          "row":"03",
          "seat":"006"
        },
        {
          "price_level_id":"011 01",
          "price_type_id":"0004000",
          "ticket_id":"000029",
          "section":"0011 01",
          "row":"03",
          "seat":"008"
        }
      ]
    }
  ]
}

Booking of 2 general admission tickets and 2 reserved seat tickets

Request Response

POST /bookings HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"es-es",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB regular"
  },
  "event_id":"000001004000004",
  "last_modification":"2019-06-13T12:45:06Z",
  "searches":[
    {
      "index":"1",
      "accept_non_adjacent":false,
      "accept_alternate":[

      ],
      "search_type":"BESTAVAIL",
      "bestavail":{
        "areas":[

        ],
        "price_level_ids":[
          "011 01",
          "012 01"
        ],
        "price_types":[
          {
            "id":"0001000",
            "quantity":"2"
          }
        ]
      }
    },
    {
      "index":"2",
      "accept_non_adjacent":false,
      "accept_alternate":[

      ],
      "search_type":"SPECIFIC",
      "specific":{
        "tickets":[
          {
            "price_level_id":"011 01",
            "price_type_id":"0003000",
            "section":"0011 01",
            "row":"03",
            "seat":"006"
          },
          {
            "price_level_id":"011 01",
            "price_type_id":"0004000",
            "section":"0011 01",
            "row":"03",
            "seat":"008"
          }
        ]
      }
    }
  ]
}
HTTP/1.1 200 OK

{
  "event_id":"000001004000004",
  "inventory_token":"000001M000000019_19090915583001",
  "inventory_ttl":"570",
  "search_results":[
    {
      "search_index":"1",
      "status":{
        "id":"0",
        "message":"Successful (no error)"
      },
      "non_adjacent":false,
      "alternate":false,
      "tickets":[
        {
          "price_level_id":"011 01",
          "price_type_id":"0001000",
          "ticket_id":"000000",
          "level":"1",
          "section":"1011 01"
        },
        {
          "price_level_id":"011 01",
          "price_type_id":"0001000",
          "ticket_id":"000001",
          "level":"1",
          "section":"1011 01"
        }
      ]
    },
    {
      "search_index":2,
      "non_adjacent":false,
      "alternate":false,
      "status":{
        "id":0,
        "message":"Successful (no error)"
      },
      "tickets":[
        {
          "price_level_id":"011 01",
          "price_type_id":"0003000",
          "ticket_id":"000030",
          "section":"0011 01",
          "row":"03",
          "seat":"006"
        },
        {
          "price_level_id":"011 01",
          "price_type_id":"0004000",
          "ticket_id":"000029",
          "section":"0011 01",
          "row":"03",
          "seat":"008"
        }
      ]
    }
  ]
}

Inventory Release

Method: DELETE

Summary: Inventory Release

Description: Release a reservation in the Partner system

/bookings/{inventory_token}

URL parameters:

Parameter Description Type Default Value Required
inventory_token Token of reservation String Yes

Response structure:

204 Successful operation (the reservation has been successfully released).

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

404 Not found (the reservation has not been found)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: runtime:3p-system

Examples:

Release a booking

Request Response

DELETE /bookings/000002M000000003_19091011032201 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 204 Successful operation (the reservation has been successfully released) 

Release an inexistent booking

Request Response

DELETE /bookings/000002M000000003_190910110322012 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 404 Not found (the reservation has not been found)   

Release a booking and the 3rd party returns an internal error

Request Response

DELETE /bookings/00000000-0000-0000-0000-000000000022 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 500 Internal error   

Retrieves an Order list

Method: GET

Summary: Retrieves an Order list

Description: Get an list of order information from the Partner system

/orders

Query parameters:

Parameter Description Type Default Value Required
venue Venue where the event take place String Yes
inventory_token Token of reservation String No
event_id Event identifier String No
start_date_time UTC date and time of first order String No
end_date_time UTC date and time of last order String No
size Page size of the response Integer 20 No
page Page number Integer 1 No

Response structure:

200 Successful operation

  • orders_info(array) - No description specified
    • { array item object }
      • event_id(string) - Parnert event id
      • inventory_order(string) - Partner order reference
      • tickets(array)
        • {array item object}
          • ticket
            • price_level_id(string) - Ticket price level id
            • price_type_id(string) - Ticket price type id
            • ticket_id(string) - Ticket id
            • level(string) - Ticket level id
            • section(string) - Ticket section id
            • row(string) - Row for reserved seat ticket. Won't be present for general admission
            • seat(string) - Seat number for reserved seat ticket. Won't be present for general admission
          • price_without_fees(string) - Price without fees (mandatory for order response)
  • page(object) - No description specified
    • size(integer) - size of page
    • total_elements(integer) - total number of available elements
    • total_pages(integer) - total number of available pages
    • number(integer) - current page number counted from 1

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: runtime:3p-system

Examples:

Retrieve information of an order with the inventory token

Request Response

GET /orders?orders?venue=000001&inventory_token=000001M000000001_19091116070701 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "orders_info":[
    {
      "event_id":"000001003000007",
      "inventory_order":"000001101301432",
      "tickets":[
        {
          "ticket":{
            "price_level_id":"013 01",
            "price_type_id":"0000000",
            "ticket_id":"000136",
            "level":"1",
            "section":"0013 01",
            "row":"01",
            "seat":"001"
          },
          "price_without_fees":"1500"
        }
      ]
    }
  ],
  "page":{
    "size":1,
    "total_elements":1,
    "total_pages":1,
    "number":1
  }
}

Retrieve information of orders from an event and a period

Request Response

GET /orders?venue=000001&start_date_time=2019-09-10T00:00:44Z&end_date_time=2019-09-12T00:00:44Z&
event_id=000001004000005&size=10&page=1 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "orders_info":[
    {
      "event_id":"000001004000005",
      "inventory_order":"000001141301337",
      "tickets":[
        {
          "ticket":{
            "price_level_id":"011 01",
            "price_type_id":"0001000",
            "ticket_id":"000000",
            "level":"1",
            "section":"1011 01"
          },
          "price_without_fees":"5000"
        },
        {
          "ticket":{
            "price_level_id":"011 01",
            "price_type_id":"0001000",
            "ticket_id":"000001",
            "level":"1",
            "section":"1011 01"
          },
          "price_without_fees":"5000"
        }
      ]
    },
    {
      "event_id":"000001004000005",
      "inventory_order":"000001151301338",
      "tickets":[
        {
          "ticket":{
            "price_level_id":"012 01",
            "price_type_id":"0001000",
            "ticket_id":"005677",
            "level":"1",
            "section":"1012 01"
          },
          "price_without_fees":"3500"
        },
        {
          "ticket":{
            "price_level_id":"012 01",
            "price_type_id":"0001000",
            "ticket_id":"005780",
            "level":"1",
            "section":"1012 01"
          },
          "price_without_fees":"3500"
        },
        {
          "ticket":{
            "price_level_id":"012 01",
            "price_type_id":"0002000",
            "ticket_id":"005781",
            "level":"1",
            "section":"1012 01"
          },
          "price_without_fees":"1750"
        },
        {
          "ticket":{
            "price_level_id":"012 01",
            "price_type_id":"0002000",
            "ticket_id":"005782",
            "level":"1",
            "section":"1012 01"
          },
          "price_without_fees":"1750"
        }
      ]
    }
  ],
  "page":{
    "size":2,
    "total_elements":2,
    "total_pages":1,
    "number":1
  }
}

Order Request (Inventory Commit)

Method: POST

Summary: Order Request (Inventory Commit)

Description: Create an order in the Partner ticketing system

/orders

Other parameters:

Parameter In Description Type Default Value Required
request body Information to create an order
OrderRequest
show all
Yes

Response structure:

200 Successful operation (it has been processed but order not created).

  • event_id(string) - Parnert event id
  • inventory_order(string) - Partner order reference
  • tickets(array) - No description specified
    • { array item object }
      • ticket
        • price_level_id(string) - Ticket price level id
        • price_type_id(string) - Ticket price type id
        • ticket_id(string) - Ticket id
        • level(string) - Ticket level id
        • section(string) - Ticket section id
        • row(string) - Row for reserved seat ticket. Won't be present for general admission
        • seat(string) - Seat number for reserved seat ticket. Won't be present for general admission
      • price_without_fees(string) - Price without fees (mandatory for order response)

201 Successful operation (the order has been successfully created).

  • event_id(string) - Parnert event id
  • inventory_order(string) - Partner order reference
  • tickets(array) - No description specified
    • { array item object }
      • ticket
        • price_level_id(string) - Ticket price level id
        • price_type_id(string) - Ticket price type id
        • ticket_id(string) - Ticket id
        • level(string) - Ticket level id
        • section(string) - Ticket section id
        • row(string) - Row for reserved seat ticket. Won't be present for general admission
        • seat(string) - Seat number for reserved seat ticket. Won't be present for general admission
      • price_without_fees(string) - Price without fees (mandatory for order response)

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: runtime:3p-system

Examples:

Confirmation of an anonymous booking paid in cash and collected at the time of purchase

Request Response

POST /orders/ HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "inventory_token":"token_3p",
  "order_info":{
    "order_id":"1012-9328",
    "order_total_amount":"2300",
    "inventory_tickets_amount":"2"
  },
  "payment_info":{
    "payment_method_type":"CASH",
    "payment_method_name":"Cash"
  },
  "delivery_info":{
    "delivery_method_type":"PU",
    "delivery_method_name":"Pick-up"
  }
}
HTTP/1.1 200 OK

{
  "event_id":"event_3p",
  "inventory_order":"order_3p",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"price_level_3p_1",
        "price_type_id":"price_type_3p",
        "ticket_id":"00000000-0000-0000-0000-000000000001",
        "level":"L1_3p",
        "section":"203_3p"
      },
      "price_without_fees":"2000",
      "entry_code":"entry code 1"
    },
    {
      "ticket":{
        "price_level_id":"price_level_3p_1",
        "price_type_id":"price_type_3p",
        "ticket_id":"00000000-0000-0000-0000-000000000002",
        "level":"L1_3p",
        "section":"203_3p"
      },
      "price_without_fees":"2000",
      "entry_code":"entry code 2"
    }
  ]
}

Confirmation of a nominal booking paid with card and "print at home" collection

Request Response

POST /orders/ HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "orderRequest":{
    "inventory_token":"000001M000000017_19090913531101",
    "order_info":{
      "order_id":"101-2343965",
      "tickets_amount":"1500",
      "tickets_quantity":"1"
    },
    "payment_info":{
      "payment_method_type":"CARD",
      "payment_method_name":"Visa",
      "payment_card_number":"****"
    },
    "delivery_info":{
      "delivery_method_type":"PH",
      "delivery_method_name":"Print at home"
    },
    "customer_info":{
      "customer_email":"4f53000d2f8942a46417cd6fcaf42b7c5fdf6c1b2a52ce86e99bef44d69d170e",
      "first_name":"Guillermo",
      "last_name":"Sanchez",
      "address":[
        "Torre Espacio",
        "Paseo de la Castellana, 259D"
      ],
      "postal_code":"28046",
      "city":"Madrid",
      "province":"Madrid",
      "country_id":724,
      "phone":"123456789"
    }
  }
}
HTTP/1.1 200 OK

{
  "event_id":"000001003000007",
  "inventory_order":"000001131301336",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0000000",
        "ticket_id":"000073",
        "level":"1",
        "section":"0011 01",
        "row":"06",
        "seat":"001"
      },
      "price_without_fees":"1500"
    }
  ]
}

Order Status

Method: GET

Summary: Order Status

Description: Get the order status from the Partner system

/orders/{inventory_order}

URL parameters:

Parameter Description Type Default Value Required
inventory_order Order reference String Yes

Response structure:

200 Successful operation

  • event_id(string) - Parnert event id
  • inventory_order(string) - Partner order reference
  • tickets(array) - No description specified
    • { array item object }
      • ticket
        • price_level_id(string) - Ticket price level id
        • price_type_id(string) - Ticket price type id
        • ticket_id(string) - Ticket id
        • level(string) - Ticket level id
        • section(string) - Ticket section id
        • row(string) - Row for reserved seat ticket. Won't be present for general admission
        • seat(string) - Seat number for reserved seat ticket. Won't be present for general admission
      • printable(boolean) - Ticket is printable.
      • printed(boolean) - Ticket was printed.
      • cancellable(boolean) - Ticket is cancellable.
      • cancelled(boolean) - Ticket was cancelled.

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

404 Not found (the order reference has not been found)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: runtime:3p-system

Examples:

Order status for an order of 1 reserved seat tickets

Request Response

GET /orders/000001131301336 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "event_id":"000001003000007",
  "inventory_order":"000001131301336",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0000000",
        "ticket_id":"000073",
        "level":"1",
        "section":"0011 01",
        "row":"06",
        "seat":"001"
      },
      "printable":true,
      "printed":false,
      "cancellable":true,
      "cancelled":false
    }
  ]
}

Order status for an order of 2 general admission tickets

Request Response

GET /orders/000001141301238 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "event_id":"000001004000005",
  "inventory_order":"000001141301238",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000003",
        "level":"1",
        "section":"1011 01"
      },
      "printable":true,
      "printed":false,
      "cancellable":true,
      "cancelled":false
    },
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000002",
        "level":"1",
        "section":"1011 01"
      },
      "printable":true,
      "printed":false,
      "cancellable":true,
      "cancelled":false
    }
  ]
}

Order Print, Order Print Rollback or Order Cancel

Method: POST

Summary: Order Print, Order Print Rollback or Order Cancel

Description: Update an order to print, to rollback the print or to cancel

/orders/{inventory_order}

URL parameters:

Parameter Description Type Default Value Required
inventory_order Order reference String Yes

Other parameters:

Parameter In Description Type Default Value Required
request body Information to update an order
OrderUpdateRequest
show all
Yes

Response structure:

200 Successful operation (the action has been processed but not modified).

  • event_id(string) - Parnert event id
  • inventory_order(string) - Partner order reference echoed
  • tickets(array) - No description specified
    • { array item object }
      • ticket
        • price_level_id(string) - Ticket price level id
        • price_type_id(string) - Ticket price type id
        • ticket_id(string) - Ticket id
        • level(string) - Ticket level id
        • section(string) - Ticket section id
        • row(string) - Row for reserved seat ticket. Won't be present for general admission
        • seat(string) - Seat number for reserved seat ticket. Won't be present for general admission
      • status
        • id(integer) - 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
        • message(string)
      • entry_code(string) - Ticket barcode. Required for "PRINT".
      • print_messages(array) - Extra info to print on the ticket
        • [ "string" ] - No description specified
  • action(string)
    -Action echoed."PRINT" - to set the sta...
    • Action echoed. "PRINT" - to set the status of the tickets to printed. "ROLLBACK_PRINT" - to reset the status to printable (for printing problems) "CANCEL" - to cancel the order

201 Successful operation (the action has been successfully e).

  • event_id(string) - Parnert event id
  • inventory_order(string) - Partner order reference echoed
  • tickets(array) - No description specified
    • { array item object }
      • ticket
        • price_level_id(string) - Ticket price level id
        • price_type_id(string) - Ticket price type id
        • ticket_id(string) - Ticket id
        • level(string) - Ticket level id
        • section(string) - Ticket section id
        • row(string) - Row for reserved seat ticket. Won't be present for general admission
        • seat(string) - Seat number for reserved seat ticket. Won't be present for general admission
      • status
        • id(integer) - 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
        • message(string)
      • entry_code(string) - Ticket barcode. Required for "PRINT".
      • print_messages(array) - Extra info to print on the ticket
        • [ "string" ] - No description specified
  • action(string)
    -Action echoed."PRINT" - to set the sta...
    • Action echoed. "PRINT" - to set the status of the tickets to printed. "ROLLBACK_PRINT" - to reset the status to printable (for printing problems) "CANCEL" - to cancel the order

400 Bad request (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

401 Unauthorized (the request has not been applied because it lacks valid authentication credentials)

403 Forbidden (resource cannot be accessed)

404 Not found (the order reference has not been found)

410 Unsuccessful operation (error description in response body)

  • id(integer)
    -0 - Successful (no error)1 - Syntax error2 - No...
    • 0 - Successful (no error) 1 - Syntax error 2 - Not processed 101 - Invalid venue id 102 - Invalid manifest id 103 - Invalid level id 104 - Invalid section id 105 - Invalid row 106 - Invalid seat 107 - Invalid price level id 108 - Invalid event id 109 - Invalid price type id 110 - Invalid language 111 - Invalid channel type 112 - Invalid payment method type 113 - Invalid delivery method type 114 - Invalid ticket id 201 - Invalid search index 202 - Invalid accept alternate criteria 203 - Invalid search type 204 - Invalid action 205 - Invalid sort criteria 206 - Invalid order id 207 - Invalid inventory tickets amount 208 - Invalid inventory tickets quantity 209 - Invalid payment card number 210 - Invalid email 211 - Invalid country id 212 - Invalid price 213 - Invalid last modification data time 214 - Invalid size page 215 - Invalid page number 216 - Invalid availability level 301 - Exceeded the number of tickets for request 302 - Exceeded the number of tickets for search 303 - Exceeded the number of available tickets 304 - Exceeded the allowed time limit 305 - Event not currently available 306 - Event have no availability 307 - Some of the requested items are not available 308 - Unauthorized sales channel 309 - The request does not correspond to the order 310 - Partial requests are not allowed 311 - Reservation has already released 312 - Reservation has expired 313 - Reservation has already been confirmed 314 - Reservation has not been found 315 - Order/Ticket has already been cancelled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available 319 - Order/Ticket has already been printed 320 - Order/Ticket has already been rollback-printed
  • message(string) - No description specified

500 Internal error

Authorization:

3p_auth: runtime:3p-system

Examples:

Full order print (2 general admission tickets)

Request Response

POST /orders/000001141301238 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"en-us",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB"
  },
  "event_id":"000001004000005",
  "action":"PRINT"
}
HTTP/1.1 200 OK

{
  "event_id":"000001004000005",
  "inventory_order":"000001141301238",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000003",
        "level":"1",
        "section":"1011 01"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      },
      "entry_code":"40005101000406",
      "print_messages":[
        "",
        "Todos los Públicos"
      ]
    },
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000002",
        "level":"1",
        "section":"1011 01"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      },
      "entry_code":"40005101000306",
      "print_messages":[
        "",
        "Todos los Públicos"
      ]
    }
  ],
  "action":"PRINT"
}

Partial order print (2 general admission tickets)

Request Response

POST /orders/000001141301238 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"en-us",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB"
  },
  "event_id":"000001004000005",
  "tickets":[
    {
      "price_level_id":"011 01",
      "price_type_id":"0001000",
      "ticket_id":"000002",
      "level":"1",
      "section":"1011 01"
    },
    {
      "price_level_id":"011 01",
      "price_type_id":"0001000",
      "ticket_id":"000003",
      "level":"1",
      "section":"1011 01"
    }
  ],
  "action":"ROLLBACK_PRINT"
}
HTTP/1.1 200 OK

{
  "event_id":"000001004000005",
  "inventory_order":"000001141301238",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000002",
        "level":"1",
        "section":"1011 01"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      },
      "entry_code":"40005101000307",
      "print_messages":[
        "",
        "Todos los Públicos"
      ]
    }
  ],
  "action":"PRINT"
}

Full order print (the 3rd party system returns an error)

Request Response

POST /orders/order_3p HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language": "es-es",
  "channel_info": {
    "channel_type": "OUTLET",
    "sub_channel_name": "FNACV ZGZ.ESPAÑA"
  },
  "event_id": "event_3p",
  "action": "PRINT"
}
HTTP/1.1 410 Unsuccessful operation (error description in response body) 
{
  "id": 305,
  "message": "Event not currently available"
}

Report a printing error

Request Response

POST /orders/000001141301238 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"en-us",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB"
  },
  "event_id":"000001004000005",
  "tickets":[
    {
      "price_level_id":"011 01",
      "price_type_id":"0001000",
      "ticket_id":"000002",
      "level":"1",
      "section":"1011 01"
    },
    {
      "price_level_id":"011 01",
      "price_type_id":"0001000",
      "ticket_id":"000003",
      "level":"1",
      "section":"1011 01"
    }
  ],
  "action":"ROLLBACK_PRINT"
}
HTTP/1.1 200 OK

{
  "event_id":"000001004000005",
  "inventory_order":"000001141301238",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000002",
        "level":"1",
        "section":"1011 01"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    },
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000003",
        "level":"1",
        "section":"1011 01"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    }
  ],
  "action":"ROLLBACK_PRINT"
}

Total cancellation of an order with 2 general admission tickets

Request Response

POST /orders/000001141301238 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"en-us",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB"
  },
  "event_id":"000001004000005",
  "action":"CANCEL"
}
HTTP/1.1 200 OK

{
  "event_id":"000001004000005",
  "inventory_order":"000001141301238",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000003",
        "level":"1",
        "section":"1011 01"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    },
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000002",
        "level":"1",
        "section":"1011 01"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    }
  ],
  "action":"CANCEL"
}

Total cancellation of an order with 2 reserved seat tickets

Request Response

POST /orders/000001111301433 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"en-us",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB"
  },
  "event_id":"000001003000007",
  "action":"CANCEL"
}
HTTP/1.1 200 OK

{
  "event_id":"000001003000007",
  "inventory_order":"000001111301433",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"012 01",
        "price_type_id":"0000000",
        "ticket_id":"000114",
        "level":"1",
        "section":"0012 01",
        "row":"03",
        "seat":"010"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    },
    {
      "ticket":{
        "price_level_id":"012 01",
        "price_type_id":"0000000",
        "ticket_id":"000113",
        "level":"1",
        "section":"0012 01",
        "row":"03",
        "seat":"012"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    }
  ],
  "action":"CANCEL"
}

Partial cancellation of an order with 2 general admission tickets

Request Response

POST /orders/000001131301435 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"en-us",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB"
  },
  "event_id":"000001004000005",
  "tickets":[
    {
      "price_level_id":"011 01",
      "price_type_id":"0001000",
      "ticket_id":"000002",
      "level":"1",
      "section":"1011 01"
    },
    {
      "price_level_id":"011 01",
      "price_type_id":"0001000",
      "ticket_id":"000003",
      "level":"1",
      "section":"1011 01"
    }
  ],
  "action":"CANCEL"
}
HTTP/1.1 200 OK

{
  "event_id":"000001004000005",
  "inventory_order":"000001131301435",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000002",
        "level":"1",
        "section":"1011 01"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    },
    {
      "ticket":{
        "price_level_id":"011 01",
        "price_type_id":"0001000",
        "ticket_id":"000003",
        "level":"1",
        "section":"1011 01"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    }
  ],
  "action":"CANCEL"
}

Partial cancellation of an order with 2 reserved seat tickets

Request Response

POST /orders/000001121301434 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language":"en-us",
  "channel_info":{
    "channel_type":"INTERNET",
    "sub_channel_name":"WEB"
  },
  "event_id":"000001003000007",
  "tickets":[
    {
      "price_level_id":"012 01",
      "price_type_id":"0000000",
      "ticket_id":"000113",
      "level":"1",
      "section":"0012 01",
      "row":"03",
      "seat":"012"
    },
    {
      "price_level_id":"012 01",
      "price_type_id":"0000000",
      "ticket_id":"000114",
      "level":"1",
      "section":"0012 01",
      "row":"03",
      "seat":"010"
    }
  ],
  "action":"CANCEL"
}
HTTP/1.1 200 OK

{
  "event_id":"000001003000007",
  "inventory_order":"000001121301434",
  "tickets":[
    {
      "ticket":{
        "price_level_id":"012 01",
        "price_type_id":"0000000",
        "ticket_id":"000113",
        "level":"1",
        "section":"0012 01",
        "row":"03",
        "seat":"012"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    },
    {
      "ticket":{
        "price_level_id":"012 01",
        "price_type_id":"0000000",
        "ticket_id":"000114",
        "level":"1",
        "section":"0012 01",
        "row":"03",
        "seat":"010"
      },
      "status":{
        "id":0,
        "message":"Successful (no error)"
      }
    }
  ],
  "action":"CANCEL"
}

Available authorizations:

3p_auth

type: oauth2

tokenUrl: http://partner.com/tm-3pi-api/login

flow: application

scopes:

check:3p-system: TM can check the Partner system

ingestion:3p-system: TM can manage manifests & events from the Partner system

runtime:3p-system: TM can manage bookings & orders to the Partner system