TM 3RD PARTY INTEGRATION API

This is the first version of the 3rd Party Integration API specification for Ticketmaster Partners. Through this, the Partners can export their contents to the Ticketmaster ticketing platform in order to sell their inventories through the sales channels enabled.

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 0 No
sort Sorting order of the search result. Allowable values - "NAME,DATE" or "DATE,NAME" 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
            • VISIBLE
            • NOT_VISIBLE
            • HIDDEN
          • visibility_override
            • visibility(string: enum)- Visibility of the event in TM sales channels at a specific date/time
              • 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)- Event name or title
                • description(string)- Event 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 or title
                • 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)- Exception price start (UTC date and time)
              • end_date_time(string)- Exception price end (UTC date and time)
            • 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)
        • ON_SALE
        • CANCELED
  • 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 0

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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • message(string)No description specified

500 Internal error

Authorization:

3p_auth: ingestion:3p-system

Examples:

Retrieve events of "venue1" venue since "August 8th at 12:00"

Request Response

GET /events?venue=venue1&last_modification=2018-08-01T12:00:00Z 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": "event_3p",
        "last_modification": "2018-08-01T14:36:16.00Z",
        "organization_info": {
          "promoter_id": "A-60905999",
          "promoter_name": "Big fish promotions"
        },
        "manifest_id": "V123/C165",
        "text_infos": [
          {
            "lang": "es-es",
            "name": "Florence + The Machine",
            "description": "Florence + The Machine la banda de indie-rock liderada por la cantante Florence Welch está de vuelta en nuestro país"
          }
        ],
        "maximum_tickets_quantity": 6,
        "genre_info": [
          {
            "genre_id": "P/R",
            "genre_name": "Pop/Rock"
          }
        ],
        "date_time": "2018-09-06T20:30:00.00Z",
        "date_time_properties": {
          "date_hidden": false,
          "time_hidden": false
        },
        "doors_date_time": "2018-09-06T18:30:10.00Z",
        "doors_date_time_properties": {
          "date_hidden": false,
          "time_hidden": false
        },
        "price_levels": [
          {
            "id": "PL1",
            "text_infos": [
              {
                "lang": "es-es",
                "name": "Categoria A",
                "description": "Categoria regular"
              }
            ]
          }
        ],
        "price_types": [
          {
            "id": "PT1",
            "regular": false,
            "text_infos": [
              {
                "lang": "es-es",
                "name": "Golden Ring Pista",
                "description": "bla bla bla",
                "additional_info": "bla bla bla",
                "printed_description": "Golden Ring"
              }
            ]
          },
          {
            "id": "PT2",
            "regular": true,
            "text_infos": [
              {
                "lang": "es-es",
                "name": "Entrada General Pista",
                "description": "bla bla bla",
                "additional_info": "bla bla bla",
                "printed_description": "Entrada General"
              }
            ]
          }
        ],
        "face_value_prices": [
          {
            "price_level_id": "PL1",
            "price_type_id": "PT1",
            "amount": "8050",
            "price_period": {
                "start_date_time": "2018-08-01T20:00:00.00Z",
                "end_date_time": "2018-09-06T23:30:00.00Z"
            }
          },
          {
            "price_level_id": "PL1",
            "price_type_id": "PT2",
            "amount": "6000",
            "price_period": {
                "start_date_time": "2018-08-01T20:00:00.00Z",
                "end_date_time": "2018-09-06T23:30:00.00Z"
            }
          }
        ]
      },
      "mod_list": [
        "NEW"
      ]
    }
  ],
  "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
        • VISIBLE
        • NOT_VISIBLE
        • HIDDEN
      • visibility_override
        • visibility(string: enum)- Visibility of the event in TM sales channels at a specific date/time
          • 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)- Event name or title
            • description(string)- Event 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 or title
            • 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)- Exception price start (UTC date and time)
          • end_date_time(string)- Exception price end (UTC date and time)
        • 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)No description specified

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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • message(string)No description specified

500 Internal error

Authorization:

3p_auth: ingestion:3p-system

Examples:

Update event information of "event_3p"

Request Response

GET /events/event_3p?last_modification=2018-08-01T14:36:16.00Z HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "event": {
    "event_id": "event_3p",
    "last_modification": "2018-08-02T11:30:00.00Z",
    "organization_info": {
      "promoter_id": "A-60905999",
      "promoter_name": "Big fish promotions"
    },
    "manifest_id": "V123-C165",
    "text_infos": [
      {
        "lang": "es-es",
        "name": "Florence + The Machine",
        "description": "Florence + The Machine la banda de indie-rock liderada por la cantante Florence Welch está de vuelta en nuestro país"
      }
    ],
    "maximum_tickets_quantity": 6,
    "genre_info": [
      {
        "genre_id": "P/R",
        "genre_name": "Pop/Rock"
      }
    ],
    "date_time": "2018-09-06T20:30:00.00Z",
    "date_time_properties": {
      "date_hidden": false,
      "time_hidden": false
    },
    "doors_date_time": "2018-09-06T18:30:10.00Z",
    "doors_date_time_properties": {
      "date_hidden": false,
      "time_hidden": false
    },
    "price_levels": [
      {
        "id": "PL1",
        "text_infos": [
          {
            "lang": "es-es",
            "name": "Categoria A",
            "description": "Categoria regular"
          }
        ]
      }
    ],
    "price_types": [
      {
        "id": "PT1",
        "regular": false,
        "text_infos": [
          {
            "lang": "es-es",
            "name": "Golden Ring Pista",
            "description": "bla bla bla",
            "additional_info": "bla bla bla",
            "printed_description": "Golden Ring"
          }
        ]
      },
      {
        "id": "PT2",
        "regular": true,
        "text_infos": [
          {
            "lang": "es-es",
            "name": "Entrada General Pista",
            "description": "bla bla bla",
            "additional_info": "bla bla bla",
            "printed_description": "Entrada General"
          }
        ]
      },
      {
        "id": "PT3",
        "regular": false,
        "text_infos": [
          {
            "lang": "es-es",
            "name": "Asiento reservado",
            "description": "bla bla bla",
            "additional_info": "bla bla bla",
            "printed_description": "Asiento reservado"
          }
        ]
      }         
    ],
    "face_value_prices": [
      {
        "price_level_id": "PL1",
        "price_type_id": "PT1",
        "amount": "8500",
        "price_period": {
            "start_date_time": "2018-08-01T20:00:00.00Z",
            "end_date_time": "2018-09-06T23:30:00.00Z"
        }
      },
      {
        "price_level_id": "PL1",
        "price_type_id": "PT2",
        "amount": "6500",
        "price_period": {
            "start_date_time": "2018-08-01T20:00:00.00Z",
            "end_date_time": "2018-09-06T23:30:00.00Z"
        }
      },
      {
        "price_level_id": "PL1",
        "price_type_id": "PT3",
        "amount": "6800",
        "price_period": {
            "start_date_time": "2018-08-01T20:00:00.00Z",
            "end_date_time": "2018-09-06T23:30:00.00Z"
        }
      }
    ]
  },
  "mod_list": [
    "UPDT.PRICE-TYPES", "UPDT.PRICES"
  ]
}

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 "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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • message(string)No description specified

500 Internal error

Authorization:

3p_auth: ingestion:3p-system

Examples:

Retrieve detailed availability information of the event "event_3p", level "L1_3p" and section "201_3p"

Request Response

GET /events/event_3p/availability?last_modification=2018-07-19T07:15:12Z&level=L1_3p&section=201_3p&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": "venue_3p",
  "manifest_id": "manif_3p",
  "rs_areas": [
    {
      "level_id": "L1_3p",
      "section_id": "201_3p",
      "quantities": {
        "available": 2,
        "unavailable": 50
      },
      "rows": [
        {
          "row": "R10_3p",
          "seats": {
            "available": [
              "3p_20",
              "3p_21"
            ]
          }
        }
      ]
    }
  ] 
}

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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • message(string)No description specified

500 Internal error

Authorization:

3p_auth: ingestion:3p-system

Examples:

Retrieve information of manifest "V123-C165"

Request Response

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

{
  "manifest_id": "V123-C165",
  "description": "Venue 123 standrad configuration",
  "venue_id": "V123",
  "total_capacity": 15500,
  "ga_areas": [
    {
      "level_id": "L0",
      "section_id": "P",
      "price_level_id": "PL1",
      "free_text": "Forbidden resale",
      "capacity": 4300
    }
  ],
  "rs_areas": [
    {
      "level_id": "L1",
      "section_id": "S100I",
      "price_level_id": "PL1",
      "free_text": "Forbidden resale",
      "rows": [
        {
          "row": "1",
          "position_y": 1,
          "seats": [
            {
              "seat": "1",
              "killed": false,
              "position_x": 3
            },
            {
              "seat": "3",
              "killed": false,
              "position_x": 2
            },
            {
              "seat": "5",
              "killed": false,
              "position_x": 1
            }
          ]
        },
        {
          "row": "2",
          "position_y": 2,
          "seats": [
            {
              "seat": "1",
              "killed": false,
              "position_x": 3
            },
            {
              "seat": "3",
              "killed": false,
              "position_x": 2
            },
            {
              "seat": "5",
              "killed": false,
              "position_x": 1
            }
          ]
        }
      ]
    },
    {
      "level_id": "L1",
      "section_id": "S100P",
      "price_level_id": "PL1",
      "free_text": "Forbidden resale",
      "rows": [
        {
          "row": "1",
          "position_y": 1,
          "seats": [
            {
              "seat": "2",
              "killed": false,
              "position_x": 1
            },
            {
              "seat": "4",
              "killed": false,
              "position_x": 2
            },
            {
              "seat": "6",
              "killed": false,
              "position_x": 3
            }
          ]
        },
        {
          "row": "2",
          "position_y": 2,
          "seats": [
            {
              "seat": "2",
              "killed": false,
              "position_x": 1
            },
            {
              "seat": "4",
              "killed": false,
              "position_x": 2
            },
            {
              "seat": "6",
              "killed": false,
              "position_x": 3
            }
          ]
        }
      ],
      "sections": [
        {
          "id": "P",
          "description": "Floor"
        },
        {
          "id": "S100I",
          "description": "Section 100 Odd"
        },
        {
          "id": "S100P",
          "description": "Section 100 Even"
        }
      ],
      "levels": [
        {
          "id": "L0",
          "description": "Level 0"
        },
        {
          "id": "L1",
          "description": "Level 1"
        }
      ],
      "price_levels": [
        {
          "id": "PL1"
        }
      ]
    }
  ]
}

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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
        • 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

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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
        • 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

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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 /tm-3pi-api/v1/bookings 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",
  "last_modification": "2018-07-19T07:15:12Z",
  "searches": [
    {
      "index": "1",
      "search_type": "BESTAVAIL",
      "bestavail": {
        "areas": [],
        "price_level_ids": [],
        "price_types": [
          {
            "id": "price_type_3p",
            "quantity": "2"
          }
        ]
      },
    }
  ]
}
HTTP/1.1 200 OK

{
  "event_id": "event_3p",
  "inventory_token": "00000000-0000-0000-0000-000000000001",
  "inventory_ttl": "1",
  "search_results": [
    {
      "search_index": "1",
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      },
      "non_adjacent": false,
      "alternate": false,
      "tickets": [
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000001",
          "level": "L1_3p",
          "section": "201_3p"
        },
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000002",
          "level": "L1_3p",
          "section": "201_3p"
        }
      ]
    }
  ]
}

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

Request Response

POST /tm-3pi-api/v1/bookings 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",
  "last_modification": "2018-07-19T07:15:12Z",
  "searches": [
    {
      "index": "1",
      "accept_alternate": [],
      "search_type": "BESTAVAIL",
      "bestavail": {
        "areas": [],
        "price_level_ids": [],
        "price_types": [
          {
            "id": "price_type_3p",
            "quantity": "2"
          },
          {
            "id": "price_type_2_3p",
            "quantity": "1"
          }
        ]
      },
    }
  ]
}
HTTP/1.1 200 OK

{
  "event_id": "event_3p",
  "inventory_token": "00000000-0000-0000-0000-000000000001",
  "inventory_ttl": "1",
  "search_results": [
    {
      "search_index": "1",
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      },
      "non_adjacent": false,
      "alternate": false,
      "tickets": [
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000001",
          "level": "L1_3p",
          "section": "201_3p"
        },
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000002",
          "level": "L1_3p",
          "section": "201_3p"
        },
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_2_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000003",
          "level": "L1_3p",
          "section": "201_3p"
        }
      ]
    }
  ]
}

Booking of 2 reserved seat tickets (1 adults and 1 child), the best available in sector 201 with the possibility of alternative in another area and not contiguous

Request Response

POST /tm-3pi-api/v1/bookings 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",
  "last_modification": "2018-07-19T07:15:12Z",
  "searches": [
    {
      "index": "1",
      "accept_non_adjacent": true,
      "accept_alternate": [
        "AREA"
      ],
      "search_type": "SPECIFIC",
      "specific": {
        "tickets": [
          {
            "price_level_id": "price_level_3p_1",
            "price_type_id": "price_type_3p",
            "level": "L1_3p",
            "section": "201_3p",
            "row": "3p_R1",
            "seat": "3p_1"
          },
          {
            "price_level_id": "price_level_3p_1",
            "price_type_id": "price_type_3p",
            "level": "L1_3p",
            "section": "201_3p",
            "row": "3p_R1",
            "seat": "3p_2"
          }
        ]
      }
    }
  ]
}
HTTP/1.1 200 OK

{
  "event_id": "event_3p",
  "inventory_token": "00000000-0000-0000-0000-000000000001",
  "inventory_ttl": "1",
  "search_results": [
    {
      "search_index": "1",
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      },
      "non_adjacent": true,
      "alternate": true,
      "tickets": [
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000003",
          "level": "L1_3p",
          "section": "202_3p",
          "row": "3p_R1",
          "seat": "3p_3"
        },
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_2_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000004",
          "level": "L1_3p",
          "section": "202_3p",
          "row": "3p_R1",
          "seat": "3p_4"
        }
      ]
    }
  ]
}

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

Request Response

POST /tm-3pi-api/v1/bookings HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language": "es-es",
  "channel_info": {
    "channel_type": "OUTLET",
    "subChannelName": "FNACV ZGZ.ESPA�A"
  },
  "event_id": "event_3p",
  "last_modification": "2018-07-19T07:15:12Z",
  "searches": [
    {
      "index": "1",
      "accept_non_adjacent": false,
      "accept_alternate": [],
      "search_type": "SPECIFIC",
      "specific": {
        "tickets": [
          {
            "price_level_id": "price_level_3p_1",
            "price_type_id": "price_type_3p",
            "level": "L1_3p",
            "section": "201_3p",
            "row": "3p_R1",
            "seat": "3p_1"
          },
          {
            "price_level_id": "price_level_3p_1",
            "price_type_id": "price_type_3p",
            "level": "L1_3p",
            "section": "201_3p",
            "row": "3p_R1",
            "seat": "3p_2"
          }
        ]
      }
    }
  ]
}
HTTP/1.1 200 OK

{
  "event_id": "event_3p",
  "inventory_token": "00000000-0000-0000-0000-000000000001",
  "inventory_ttl": "1",
  "search_results": [
    {
      "search_index": "1",
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      },
      "non_adjacent": false,
      "alternate": false,
      "tickets": [
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000001",
          "level": "L1_3p",
          "section": "201_3p",
          "row": "3p_R1",
          "seat": "3p_1"
        },
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_2_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000002",
          "level": "L1_3p",
          "section": "201_3p",
          "row": "3p_R1",
          "seat": "3p_2"
        }
      ]
    }
  ]
}

Booking of 2 general admission tickets and 2 reserved seat tickets

Request Response

POST /tm-3pi-api/v1/bookings HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive

{
  "language": "es-es",
  "channel_info": {
    "channel_type": "OUTLET",
    "subChannelName": "FNACV ZGZ.ESPA�A"  },
  "event_id": "event_3p",
  "last_modification": "2018-07-19T07:15:12Z",
  "searches": [
    {
      "index": "1",
      "accept_alternate": [],
      "search_type": "BESTAVAIL",
      "bestavail": {
        "areas": [],
        "price_level_ids": [],
        "price_types": [
          {
            "id": "price_type_3p",
            "quantity": "2"
          }
        ]
      },
    },
    {
      "index": "2",
      "accept_non_adjacent": false,
      "accept_alternate": [],
      "search_type": "SPECIFIC",
      "specific": {
        "tickets": [
          {
            "price_level_id": "price_level_3p_1",
            "price_type_id": "price_type_3p",
            "level": "L1_3p",
            "section": "202_3p",
            "row": "3p_R1",
            "seat": "3p_3"
          },
          {
            "price_level_id": "price_level_3p_1",
            "price_type_id": "price_type_3p",
            "level": "L1_3p",
            "section": "202_3p",
            "row": "3p_R1",
            "seat": "3p_4"
          }
        ]
      }
    }
  ]
}
HTTP/1.1 200 OK

{
  "event_id": "event_3p",
  "inventory_token": "00000000-0000-0000-0000-000000000001",
  "inventory_ttl": "1",
  "search_results": [
    {
      "search_index": "1",
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      },
      "non_adjacent": false,
      "alternate": false,
      "tickets": [
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000001",
          "level": "L1_3p",
          "section": "201_3p"
        },
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000002",
          "level": "L1_3p",
          "section": "201_3p"
        }
      ]
    },
    {
      "search_index": "2",
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      },
      "non_adjacent": true,
      "alternate": true,
      "tickets": [
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000003",
          "level": "L1_3p",
          "section": "202_3p",
          "row": "3p_R1",
          "seat": "3p_3"
        },
        {
          "price_level_id": "price_level_3p_1",
          "price_type_id": "price_type_2_3p",
          "ticket_id": "00000000-0000-0000-0000-000000000004",
          "level": "L1_3p",
          "section": "202_3p",
          "row": "3p_R1",
          "seat": "3p_4"
        }
      ]
    }
  ]
}

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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • message(string)No description specified

500 Internal error

Authorization:

3p_auth: runtime:3p-system

Examples:

Release a booking

Request Response

DELETE /bookings/00000000-0000-0000-0000-000000000001 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/00000000-0000-0000-0000-000000000666 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
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 0 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
          • 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 0

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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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?inventory_token=00000000-0000-0000-0000-000000000001 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
   "orders_info":[
      {
         "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"
            },
            {
               "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"
            }
         ]
      }
   ],
   "page":{
      "size":1,
      "total_elements":1,
      "total_pages":1,
      "number":0
   }
}

Retrieve information of orders from an event and a period

Request Response

GET /orders?event_id=event_3p&start_date_time=2018-09-06T23:30:00.00Z&end_date_time=2018-09-06T23:40:00.00Z&size=2&page=0 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
   "orders_info":[
      {
         "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"
            },
            {
               "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"
            }
         ]
      },
      {
         "event_id":"event_3p",
         "inventory_order":"order_2_3p",
         "tickets":[
            {
               "ticket":{
                  "price_level_id":"price_level_3p_1",
                  "price_type_id":"price_type_3p",
                  "ticket_id":"00000000-0000-0000-0000-000000000003",
                  "level":"L1_3p",
                  "section":"201_3p",
                  "row":"3p_R1",
                  "seat":"3p_1"
               },
               "price_without_fees":"2000"
            },
            {
               "ticket":{
                  "price_level_id":"price_level_3p_1",
                  "price_type_id":"price_type_3p",
                  "ticket_id":"00000000-0000-0000-0000-000000000004",
                  "level":"L1_3p",
                  "section":"201_3p",
                  "row":"3p_R1",
                  "seat":"3p_2"
               },
               "price_without_fees":"2000"
            }
         ]
      }
   ],
   "page":{
      "size":2,
      "total_elements":5,
      "total_pages":3,
      "number":0
   }
}

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
      • 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
      • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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"
  }
}
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

{
  "inventory_token": "token_3p",
  "order_info": {
    "order_id": "1012-9328",
    "order_total_amount": "2300",
    "inventory_tickets_amount": "2"
  },
  "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": "guillermo.sanchez@ticketmaster.es",
    "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": "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": "201_3p",
        "row": "3p_R1",
        "seat": "3p_1"
      },
      "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": "201_3p",
        "row": "3p_R1",
        "seat": "3p_2"
      },
      "price_without_fees": "2000",
      "entry_code": "entry code 2"
    }
  ]
}

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
      • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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/19720 HTTP/1.1
Host: partner.com
X-Target-URI: https://partner.com
Connection: Keep-Alive
HTTP/1.1 200 OK

{
  "event_id": "3p_11257",
  "inventory_order": "19720",
  "tickets": [
    {
      "ticket": {
        "price_level_id": "3P_price_premium",
        "price_type_id": "3p_1",
        "ticket_id": "8c99ee68-81d6-442f-ab36-a9cb40bfa5a1",
        "level": "3p_L2",
        "section": "3p_RSArea_1",
        "row": "3p_A",
        "seat": "3p_1001"
      },
      "printable": true,
      "printed": false,
      "cancellable": true,
      "cancelled": false
    }]
}

Order status for an order of 2 general admission tickets

Request Response

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

{
  "event_id": "3p_11257",
  "inventory_order": "19612",
  "tickets": [
    {
      "ticket": {
        "price_level_id": "3P_price_premium",
        "price_type_id": "3p_1",
        "ticket_id": "7c99ee68-81d6-442f-ab36-a9cb40bfa5a1",
        "level": "3p_L2",
        "section": "3p_RSArea_1"
      },
      "printable": true,
      "printed": false,
      "cancellable": true,
      "cancelled": false
    },
    {
      "ticket": {
        "price_level_id": "3P_price_premium",
        "price_type_id": "3p_1",
        "ticket_id": "7c99ee68-81d6-442f-ab36-a9cb40bfa5a2",
        "level": "3p_L2",
        "section": "3p_RSArea_1"
      },
      "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
      • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
        • message(string)
      • entry_code(string)- Ticket barcode. Required for "PRINT" or "ROLLBACK_PRINT".
      • print_messages(array)- Extra info to print on the ticket
        • [ "string" ] - No description specified
  • action(string)
    - Action echoed."PRINT" - to set the status of th...
    • 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
      • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
        • message(string)
      • entry_code(string)- Ticket barcode. Required for "PRINT" or "ROLLBACK_PRINT".
      • print_messages(array)- Extra info to print on the ticket
        • [ "string" ] - No description specified
  • action(string)
    - Action echoed."PRINT" - to set the status of th...
    • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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 order total amount 208 - Invalid inventory tickets amount 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 has already been canceled 316 - Exceeded the number of tickets for customer 317 - Venue not currently available 318 - Manifest not currently available
  • 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/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 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": "201_3p"
      },
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      },
      "entry_code": "entry_code",
      "print_messages": [
        "print message"
      ]
    },
    {
      "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": "201_3p"
      },
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      },
      "entry_code": "entry_code",
      "print_messages": [
        "print message"
      ]
    }
  ],
  "action": "PRINT"
}

Partial order print (2 general admission tickets)

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",
  "tickets": [
    {
      "price_level_id": "price_level_3p_1",
      "price_type_id": "price_type_3p",
      "ticket_id": "00000000-0000-0000-0000-000000000001",
      "level": "L1_3p",
      "section": "201_3p"
    }
  ],
  "action": "PRINT"
}
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": "201_3p"
      },
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      },
      "entry_code": "entry_code",
      "print_messages": [
        "print message"
      ]
    }
  ],
  "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/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",
  "tickets": [
    {
      "price_level_id": "price_level_3p_1",
      "price_type_id": "price_type_3p",
      "ticket_id": "00000000-0000-0000-0000-000000000003",
      "level": "L1_3p",
      "section": "202_3p",
      "row": "3p_R1",
      "seat": "3p_3"
    }
  ],
  "action": "ROLLBACK_PRINT"
}
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-000000000003",
        "level": "L1_3p",
        "section": "202_3p",
        "row": "3p_R1",
        "seat": "3p_3"
      },
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      }
    }
  ],
  "action": "ROLLBACK_PRINT"
}

Total cancellation of an order with 2 general admission tickets

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",
    "subChannelName": "FNACV ZGZ.ESPAÑA"
  },
  "event_id": "event_3p",
  "action": "CANCEL"
}
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": "201_3p"
      },
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      }
    },
    {
      "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": "201_3p"
      },
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      }
    }
  ],
  "action": "CANCEL"
}

Total cancellation of an order with 2 reserved seat tickets

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": "CANCEL"
}
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-000000000003",
        "level": "L1_3p",
        "section": "202_3p",
        "row": "3p_R1",
        "seat": "3p_3"
      },
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      }
    },
    {
      "ticket": {
        "price_level_id": "price_level_3p_1",
        "price_type_id": "price_type_3p",
        "ticket_id": "00000000-0000-0000-0000-000000000004",
        "level": "L1_3p",
        "section": "202_3p",
        "row": "3p_R1",
        "seat": "3p_4"
      },
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      }
    }
  ],
  "action": "CANCEL"
}

Partial cancellation of an order with 2 general admission tickets

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",
  "tickets": [
    {
      "price_level_id": "price_level_3p_1",
      "price_type_id": "price_type_3p",
      "ticket_id": "00000000-0000-0000-0000-000000000001",
      "level": "L1_3p",
      "section": "201_3p"
    }
  ],
  "action": "CANCEL"
}
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": "201_3p"
      },
      "status": {
        "id": "0",
        "message": "Successful (no error)"
      }
    }
  ],
  "action": "CANCEL"
}

Partial cancellation of an order with 2 reserved seat tickets

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",
  "tickets": [
    {
      "price_level_id": "price_level_3p_1",
      "price_type_id": "price_type_3p",
      "ticket_id": "00000000-0000-0000-0000-000000000003",
      "level": "L1_3p",
      "section": "201_3p",
      "row": "3p_R1",
      "seat": "3p_1"
    }
  ],
  "action": "CANCEL"
}
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-000000000003",
        "level": "L1_3p",
        "section": "202_3p",
        "row": "3p_R1",
        "seat": "3p_3"
      },
      "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