Retrieve Tickets

AirTicketing offers two options to retrieve tickets:

Ticket Display retrieves a single ticket and details such as fare, passenger name, flight origin and destination details, and ticketed date.
Ticket Index lists all tickets issued on the reservation.

When a PNR has already been ticketed, either a Ticket Display or a PNR Retrieve can be used to display ticket details. The TicketDisplay response returns basic itinerary, price, and ticketing details. The PNR Retrieve response contains additional details that were provided in the booking workflow, including offer and traveler reference details. The PNR retrieve also lists all travelers on a PNR, while TicketDisplay returns ticket details only for the single ticket number sent in the request.

In this topic:

Retrieve a Single Ticket (TicketDisplay)
- Ticket Display Response Example
List All Tickets (Ticket Index)
- Ticket Index Response Example

Retrieve a Single Ticket

Query Parameters

None.

GET Request

Get ticket/tickets/{ticketnumber}

Send the ticket number returned at issuance.

Base path:

Pre-production https://api.pp.travelport.com/9/air/

Production https://api.travelport.com/9/air/

Payload

None.

Response

The Ticket Display response returns the reservation locator, traveler name, form of payment details, flight departure and arrival information, a price breakdown by PTC, and agency information.

Object	Description
TicketListResponse	Top level object for response. Includes the TicketID object.
TicketID	Contains all ticketing details. Key value pairs: settlementAuthorizationCode: Settlement authorization code from ticket issuance. This number is returned from the carrier and is the payment settlement for the final status code. numberOfTicketsIssued: The number of tickets issued. Multiple ticket numbers are issued for itineraries with more than four segments, or for more than one passenger. PricingType:This value is usually Auto Priced but could be Manual if back-end processing was required to issue the ticket. Includes the Identifier, PersonName, ReservationLocator, FormOfPayment, FlightSegment, TicketPrice, TermsAndConditionsFull, AgencyInfo, FlightProduct, and PricingType objects.
Identifier	Contains the ticket number in the value attribute.
PersonName	Traveler name. Key value pairs: Given: Traveler given name. Surname: Traveler surname.
ReservationLocator	Reservation locator. Key value pairs: supplierCode: Supplier ID for the supplier issuing the ticket. value: Reservation locator code.
FormOfPayment	Top level object for the type of form of payment. Includes PaymentCard if payment was made by credit card.
PaymentCard	If payment was made by credit card, card details. Key value pairs: expireDate: Card expiration date. approvalCode. Approval code for the transaction. CardCode: Card code. Contains CardNumber object.
CardNumber	If payment was made by credit card, the card number, provided in encrypted format in the encryptedValue attribute.
FlightSegment	Flight details for the flight or connecting flights making up one leg of the itinerary. Multiple FlightSegment objects are returned for itineraries with more than one leg, such as round-trip or multi-city. Contains one or more Flight objects. The sequence attribute preceding each Flight object identifies the order of that flight within the segment.
Flight	One instance returned for each flight in the FlightSegment. Key value pairs: carrier: Airline carrier code. number: Flight number. Includes the Departure, Arrival, and Status objects.
Departure	Key value pairs: location: Airport code of departure. date: Date of departure. time: Time of departure.
Arrival	Key value pairs: location: Airport code of arrival. date:: Date of arrival. time: Time of arrival.
Status	Includes ProviderStatus object.
ProviderStatus	Includes the value attribute. Possible values vary with any actions that may have been taken with the ticket and may include Open for Use (ticket can be used), Voided, Refunded, etc.
TicketPrice	Includes PriceBreakdown object.
FiledAmount	Key value pairs: currencyCode: The currency code of the transaction. value: The amount of the payment in the specified currency.
PriceBreakdown	Price details for each PTC. In the case of multiple instances, each PriceBreakdown object returns pricing for one passenger of a single PTC. On multi-passenger itineraries, you must multiply this price by the number of passengers in that PTC for the total fare for that PTC. Includes requestedPassengerType for the PTC code and the Amount object.
Amount	Price details for the requestedPassengerType in PriceBreakdown. Key value pairs: currencyCode: Indicates the currency code of the following amounts. Base: The amount of the base fare for one passenger of that PTC type. Total: Total of base fare and all taxes. Includes the Taxes object.
Taxes	Top level object for individual Tax objects for each separate tax in the fare.
Tax	Each instance of Tax provides details on a specific tax. Key value pairs: taxCode: The country code imposing the tax. value: The amount of the tax, in the currency specified in Amount @currencyCode.
TermsAndConditionsFull	Optional in response. Any terms and conditions returned by the carrier. Includes the validatingCarrier attribute (provides the IATA code for the validating carrier) and the Restriction object.
Restriction	Any fare restriction information returned by the carrier.
AgencyInfo	Details about the ticketing agency. Key value pairs: ticketedDate: Date the itinerary was ticketed in YYYY-DD-MM format. name: Ticketing agency name. ticketingPCC: Agency PCC. code: Agency code. ticketingCity: Agency city.
FlightProduct	Class of service and fare code details for each flight in the itinerary. Key value pairs: segmentSequence: Identifies this flight in the sequence, starting with 1 for the first flight in the sequence. Matches the sequence numbers in FlightSegment @sequence. Flight Segment contains the flight details such as departure, arrival, and time. classOfService: The booked class of service. fareBasisCode: The fare basis code, also called the ticket designator.

Example Ticket Display Response

The example below returns itinerary, price, and ticketing details for the ticket number requested.

Show Example Ticket Display Response

{
  "TicketListResponse": {
    "TicketID": [
      {
        "@type": "TicketDetail",
        "numberOfTicketsIssued": 1,
        "Identifier": {
          "value": "0063767199717"
        },
        "PersonName": {
          "@type": "PersonName",
          "Given": "SARAVANANMN",
          "Surname": "SATHISHA"
        },
        "ReservationLocator": {
          "supplierCode": "1G",
          "value": "6Q0RFS"
        },
        "FormOfPayment": [
          {
            "@type": "FormOfPaymentCash"
          }
        ],
        "FlightSegment": [
          {
            "sequence": 1,
            "Flight": {
              "@type": "FlightStatus",
              "carrier": "DL",
              "number": "1265",
              "Departure": {
                "@type": "Departure",
                "location": "ATL",
                "date": "2020-08-25",
                "time": "08:11:00"
              },
              "Arrival": {
                "@type": "Arrival",
                "location": "DEN"
              },
              "Status": {
                "@type": "StatusDetail",
                "ProviderStatus": {
                  "value": "Open for Use"
                }
              }
            }
          },
          {
            "sequence": 2,
            "Flight": {
              "@type": "FlightStatus",
              "carrier": "DL",
              "number": "1342",
              "Departure": {
                "@type": "Departure",
                "location": "DEN",
                "date": "2020-08-31",
                "time": "17:45:00"
              },
              "Arrival": {
                "@type": "Arrival",
                "location": "ATL"
              },
              "Status": {
                "@type": "StatusDetail",
                "ProviderStatus": {
                  "value": "Open for Use"
                }
              }
            }
          }
        ],
        "TicketPrice": {
          "@type": "TicketPriceDetail",
          "FiledAmount": {
            "currencyCode": "USD",
            "value": 94
          },
          "PriceBreakdown": [
            {
              "@type": "PriceBreakdownAir",
              "requestedPassengerType": "ADT",
              "Amount": {
                "currencyCode": "AUD",
                "Base": "155.00",
                "Taxes": {
                  "@type": "TaxesDetail",
                  "Tax": [
                    {
                      "taxCode": "AY",
                      "value": 18.4
                    },
                    {
                      "taxCode": "XF",
                      "value": 14.8
                    }
                  ]
                },
                "Total": "188.20"
              }
            }
          ]
        },
        "Commission": {
          "@type": "CommissionAmount",
          "Amount": {
            "value": 123
          }
        },
        "TermsAndConditionsFull": {
          "@type": "TermsAndConditionsFullAir",
          "validatingCarrier": "006",
          "BaggageAllowance": [
            {
              "@type": "BaggageAllowanceDetail",
              "BaggageItem": [
                {
                  "quantity": 1,
                  "BaggageFee": {
                    "code": "USD",
                    "value": 30
                  }
                },
                {
                  "quantity": 2,
                  "BaggageFee": {
                    "code": "USD",
                    "value": 40
                  }
                },
                {
                  "quantity": 1,
                  "BaggageFee": {
                    "code": "USD",
                    "value": 30
                  }
                },
                {
                  "quantity": 2,
                  "BaggageFee": {
                    "code": "USD",
                    "value": 40
                  }
                },
                {
                  "quantity": 1,
                  "BaggageFee": {
                    "code": "USD",
                    "value": 0
                  }
                },
                {
                  "quantity": 1,
                  "BaggageFee": {
                    "code": "USD",
                    "value": 0
                  }
                }
              ]
            }
          ],
          "Restriction": [
            {
              "value": "NONREFNOCHGSNOPRE RSVDSEATNON REFUNDABLE"
            }
          ]
        },
        "AgencyInfo": {
          "ticketedDate": "2020-06-01",
          "ticketingPCC": "79JP",
          "code": "02355662",
          "ticketingCountry": "AU",
          "ticketingCity": "MEL"
        },
        "FlightProduct": [
          {
            "segmentSequence": [
              1,
              2
            ],
            "classOfService": "E",
            "fareBasisCode": "XAUNJ0BG"
          }
        ],
        "PricingType": "Auto Priced"
      }
    ]
  }
}

List All Tickets (Ticket Index)

Send a ticket index request to list all tickets issued on the reservation.

Query Parameters

None.

GET Request

Get receipt/reservations/{PNR}/receipts

Base path:

Pre-production https://api.pp.travelport.com/9/air/

Production https://api.travelport.com/9/air/

Payload

None.

Response

For each ticket on the requested PNR, the response returns the traveler name and the ticket number.

Object	Description
ReceiptListResponse	Top level object for response. Includes the ReceiptID object.
ReceiptId	Contains all ticketing details. One instance returned for each ticket on the PNR.
Document	Top level object for ticket number.
Number	Ticket number.

Ticket Index Response Example

The example Ticket Index response returns the two tickets on the reservation.

Show Example Response

{
 "ReceiptListResponse": {
  "ReceiptID": [
   {
    "@type": "ReceiptPayment",
    "Document": [
     {
      "@type": "Document",
      "Number": "0163767353086"
     },
     {
      "@type": "Document",
      "Number": "0163767353087"
     }
    ]
   }
  ]
 }
}