GDS Ticket Retrieve API Reference

Get	ticket/tickets/{ticketID} Send the ticket number in {ticketID}. Base path: Pre-production https://api.pp.travelport.com/11/air/ Production https://api.travelport.com/11/air/

Related Content: Ticket Cancel, Refund, & Exchange Guide

GDS

Global Distribution System. A GDS aggregates and distributes air, hotel, and car rental content such as schedules, fares, and upsells. In the JSON APIs, GDS content is distributed from Travelport. only. To retrieve an NDC

New Distribution Capability, an XML standard for exchanging data that supports airlines in distributing their content directly to online travel agencies. See the NDC Guide. ticket use the NDC Ticket Retrieve API.

The Ticket Retrieve request returns details for a single ticket for a GDS itinerary The entire trip on a booking, including all flights on all legs. Also called a journey..

Also see:

To list all ticket numbers on a single reservation, send a Ticket List request.
To retrieve all reservation details by ticket number, send a Reservation Retrieve request with the ticket number.

Request

Also see Authorization and Common Headers.

The Ticket Retrieve API requires a GET request with the ticket number to the endpoint above. There are no query parameters or message payload.

Response

The Ticket Display response returns the reservation locator Unique six-character alphanumeric code returned for a successful booking, e.g. JS7GH4. For NDC the airline returns an additional locator code, which can be called the vendor locator code. Sometimes called a PNR and used to refer to the booking record as a whole, but because the term PNR is specific to GDS, this online help uses the more generic terms "booking" for the booking record and "reservation locator" for the six-character code., traveler name, form of payment details, flight departure and arrival information, a price breakdown by PTC Passenger Type Code, used to categorize travelers. The most common PTCs are adult (ADT), child (CNN), and infant (INF). You can request a maximum of 9 passengers in one Search request., and agency information.

Show Response Body Table

Object	Description
TicketListResponse	Top level object for response. Includes the TicketID object.
TicketID	Contains all ticketing details. May include the following: settlementAuthorizationCode: Settlement authorization code from ticket issuance. This number is returned from the carrier An airline. 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. Depending on the data available for the ticket, may include the Identifier, PersonName, ReservationLocator, FormOfPayment, TicketSegment, TicketPrice, PassengerTypeCode, ValidatingCarrier, PricingType, AgencyInfo, Restrictions, and FlightProduct 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	Returned if payment was made by credit card. Key value pairs: encryptedValue: Card number in encrypted format.
TicketSegment	Flight details for the flight or connecting flights making up one leg The flight or connecting flights between one origin and destination pair. For example, on a round-trip flight, LAX > MSP could be the first leg (aka outbound leg) and MSP > DEN > LAX could be the second leg (aka inbound leg). The JSON APIs use the term product for one leg of the itinerary. of the itinerary. Multiple instances are returned for itineraries with more than one leg, such as round-trip An itinerary in which travel goes to a single destination and returns to the origin. E.g., LHR > CDG and CDG > LHR. or multi-city An itinerary that includes multiple destinations; e.g., LHR > CDG > AMS > BCN.. Key value pairs: sequence: Identifies the order of this leg within the itinerary. connectionInd: Returned if true to indicate the leg includes a connecting flight. ClassOfService: Class of service code. FareBasisCode: Fare basis code for the flight. Status: Ticket status. 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. Carrier: Airline carrier code. Number: Flight number. Includes Departure, Arrival, and TicketBaggage 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.
TicketBaggage	Any baggage that is part of the ticket. Key value pairs: quantity: Number. Returned if baggage is sold or allowed by piece. soldByPieceInd: Boolean. Returned only if true. Indicates baggage allowance is by piece, such as one, two, or three pieces. AirReservation 25.11.59 and later. soldByWeightInd: Boolean. Returned only if true. Indicates the baggage is allowed by weight, either kilograms or pounds, such as 50 pounds or 35 kilograms. If returned, TicketBaggage also includes the Measurement objects. AirReservation 25.11.59 and later
Measurement	Returned in TicketBaggage as applicable and available when baggage is allowed or sold by weight or other measurement. Key value pairs: measurementType: Type of measurement specified, such as weight, height, width, etc. unit: Unit in which measurement is specified, such as Kilograms, Inches, Centimeters, etc. value: The number of units allowed for this measurement type.
TicketPrice	Ticket price details. Key value pairs: fareCalculation: When available, FareCalculation returns the fare calculation ladder for all public and private fare Special air fares negotiated by agencies. Private fares may use account names, account codes, contract codes, or corporate IDs. types filed by an agency or an airline. Returned as a string with unlimited bytes. GDS only, not supported for NDC. fareBreakdown: Text string returned by the carrier providing information such as listed charges and rate of exchanges. Includes CurrencyCode, Base, Taxes, and Total objects.
CurrencyCode	Indicates in the value attribute the code for the currency in which the amounts in TicketPrice are returned.
Base	The amount of the base fare.
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: currencyCode: The currency code of the tax. taxCode: The country code imposing the tax. value: The amount of the tax, in the currency specified in Amount/currencyCode.
Total	Total of all taxes plus base fare.
PassengerTypeCode	PTC for the passenger on this ticket.
ValidatingCarrier	The IATA International Air Transportation Association, an organization that standardizes rules, regulations and fare construction principles for the international travel industry. code for the validating carrier.
PricingType	This value is usually Auto Priced but could be Manual if back-end processing was required to issue the ticket.
Restrictions	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 Pseudo city code. A travel provider's identification code for the JSON APIs, provisioned from Travelport. Used to determine access and other settings in the JSON APIs for your company.. code: Agency code. ticketingCountry: Agency country. 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 Request

There is no message payload. The GET request looks like:

https://api.travelport.com/11/air/ticket/ticket/0067744639158

Example Response

For additional examples and scenarios, download the developer toolkits and see Using Postman and Developer Toolkits.

Show Example ticket retrieve response

{
 "TicketListResponse": {
  "TicketID": [
   {
    "@type": "TicketSummary",
    "numberOfTicketsIssued": 1,
    "Identifier": {
     "value": "0169904503844"
    },
    "PersonName": {
     "@type": "PersonName",
     "Given": "TESTFIRST",
     "Surname": "TESTLAST"
    },
    "ReservationLocator": {
     "supplierCode": "1G",
     "value": "1TRBJ4"
    },
    "FormOfPayment": [
     {
      "value": "Cash"
     }
    ],
    "TicketSegment": [
     {
      "@type": "TicketSegment",
      "sequence": 1,
      "connectionInd": true,
      "ClassOfService": "U",
      "FareBasisCode": "UAA0OKEM",
      "Status": "OpenForUse",
      "Carrier": "UA",
      "Number": "2240",
      "Departure": {
       "@type": "Departure",
       "location": "ONT",
       "date": "2022-08-29",
       "time": "06:00:00"
      },
      "Arrival": {
       "@type": "Arrival",
       "location": "SFO"
      },
      "TicketBaggage": {
       "@type": "TicketBaggage",
       "quantity": 0
      }
     },
     {
      "@type": "TicketSegment",
      "sequence": 2,
      "ClassOfService": "U",
      "FareBasisCode": "UAA0OKEM",
      "Status": "OpenForUse",
      "Carrier": "UA",
      "Number": "520",
      "Departure": {
       "@type": "Departure",
       "location": "SFO",
       "date": "2022-08-29",
       "time": "09:00:00"
      },
      "Arrival": {
       "@type": "Arrival",
       "location": "JFK"
      },
      "TicketBaggage": {
       "@type": "TicketBaggage",
       "quantity": 3
	"soldByPieceInd": true
      }
     }
    ],
    "TicketPrice": {
     "@type": "TicketPrice",
     "fareCalculation": "G",
     "fareBreakdown": "ONT UA X/SFO UA NYC 544.19 USD544.19END ZPONTSFO",
     "CurrencyCode": {
      "decimalPlace": 2,
      "value": "AUD"
     },
     "Base": 756,
     "Taxes": {
      "@type": "TaxesDetail",
      "Tax": [
       {
        "currencyCode": "AUD",
        "taxCode": "AY",
        "decimalPlace": 2,
        "value": 7.8
       },
       {
        "currencyCode": "AUD",
        "taxCode": "US",
        "decimalPlace": 2,
        "value": 56.7
       },
       {
        "currencyCode": "AUD",
        "taxCode": "ZP",
        "decimalPlace": 2,
        "value": 12.6
       },
       {
        "currencyCode": "AUD",
        "taxCode": "XF",
        "decimalPlace": 2,
        "value": 12.6
       }
      ]
     },
     "Total": 845.7,
     "FiledAmount": {
      "currencyCode": "USD",
      "decimalPlace": 2,
      "value": 544.19
     }
    },
    "PassengerTypeCode": "ADT",
    "ValidatingCarrier": "016",
    "PricingType": "Auto Priced",
    "Restrictions": [
     "REFUNDABLE"
    ],
    "AgencyInfo": {
     "ticketedDate": "2022-07-30",
     "name": "TEST CUSTOMER",
     "ticketingPCC": "TEST",
     "code": "12345678",
     "ticketingCountry": "AU",
     "ticketingCity": "SYD"
    }
   }
  ]
 }
}

The following example is for a ticket that has been exchanged; it returns details of the previously exchanged ticket in the PreviousIssue object.

Show Example for exchanged ticket

{ "TicketListResponse": { "@type": "TicketListResponse", "TicketID": [ { "@type": "TicketSummary", "numberOfTicketsIssued": 1, "Identifier": { "value": "0759904836638" }, "PersonName": { "@type": "PersonName", "Given": "LATHA", "Surname": "DEVI" }, "ReservationLocator": { "supplierCode": "1G", "value": "5DGV5P" }, "FormOfPayment": [ { "value": "Cash" } ], "TicketSegment": [ { "@type": "TicketSegment", "sequence": 1, "ClassOfService": "Y", "FareBasisCode": "YDNNEOM2/TNETML", "Status": "OpenForUse", "Carrier": "IB", "Number": "3402", "Departure": { "@type": "Departure", "location": "MAD", "date": "2023-10-24", "time": "07:30:00" }, "Arrival": { "@type": "Arrival", "location": "ORY" }, "TicketBaggage": { "@type": "TicketBaggage", "soldByWeightInd": true, "Measurement": [ { "measurementType": "Weight", "unit": "Kilograms", "value": 30 } ] } } ], "TicketPrice": { "@type": "TicketPrice", "fareCalculation": "A", "fareBreakdown": "[MAD IB PAR Q16.35 M/BT END ROE0.91728", "bTFareInd": true, "CurrencyCode": { "value": "EUR" }, "Base": 0, "Taxes": { "@type": "TaxesDetail", "Tax": [ { "currencyCode": "EUR", "taxCode": "XT", "value": 18.38 }, { "currencyCode": "EUR", "taxCode": "JD", "value": 14.48 }, { "currencyCode": "EUR", "taxCode": "OG", "value": 0.63 }, { "currencyCode": "EUR", "taxCode": "QV", "value": 3.27 } ] }, "Total": 516.38, "PaidTaxes": { "@type": "PaidTaxesDetail", "Tax": [ { "taxCode": "JD", "value": 14.48 }, { "taxCode": "OG", "value": 0.63 }, { "taxCode": "QV", "value": 3.27 } ] } }, "PassengerTypeCode": "ADT", "ValidatingCarrier": "075", "Restrictions": [ "[015118.REF AND CHGS RESTRI/RESTRICTIONS MAY APPLY]" ], "AgencyInfo": { "ticketedDate": "2023-09-19", "name": "GALILEO SPAIN HELPDESK", "ticketingPCC": "DU7", "code": "78299992", "ticketingCountry": "ES", "ticketingCity": "MAD" }, "PreviousIssue": [ { "issuingCity": "PAR", "issueDate": "2023-09-19", "agencyCodeIATA": "20299926", "documentType": "Ticket", "value": "0759904650787" } ] } ] } }