NDC Ticket Retrieve API Reference

POST	ticket/tickets/getbylocator Base path: Pre-production https://api.pp.travelport.com/11/air/ Production https://api.travelport.com/11/air/

Request

Also see Authorization and Common Headers.

Query Parameters

None.

Request Body

Show Request Body Table

Object	Description	Required/Optional
TicketQueryGetByLocator	Top level object Includes Locator and TicketNumber.	Required
Locator	Top level object for locator code.	Required
value	Send 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. code.	Required
locatorType	Send with the value Locator.	Required
TIcketNumber	Top level object for ticket number.	Required
value	Send the ticket number.	Required
contentSource	Send with the value NDC.	Required

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 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. Not all details may be returned if not part of the booking A confirmed reservation with the carrier. A held booking is a reservation that has not yet been ticketed. The terms booking and reservation are interchangeable. record.

Show Response Body Table

Object	Description
TicketListResponse	Top level object for response. Includes the Ticket object.
Ticket	Contains all ticketing details. May include the following: 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 (see below) to represent one leg of the itinerary. of the itinerary The entire trip on a booking, including all flights on all legs. Also called a journey.. 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. 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.
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. 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

Show Example NDC Ticket Retrieve request

{
	"TicketQueryGetByLocator": {
		"Locator": {
			"value": "7KPPBF",
			"locatorType": "Locator"
		},
		"TicketNumber": [
			{
				"value": "0572317564374",
				"contentSource": "NDC"
			}
		]
	}
}

Example Response

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

Show Example NDC Ticket Retrieve response

{
 "TicketListResponse": {
  "@type": "TicketListResponse",
  "Ticket": [
   {
    "@type": "Ticket",
    "numberOfTicketsIssued": 1,
    "Identifier": {
     "value": "0572317692477"
    },
    "PersonName": {
     "@type": "PersonName",
     "Prefix": "MR",
     "Given": "PX ADTTWO",
     "Surname": "SRNMONE"
    },
    "ReservationLocator": {
     "supplierCode": "1G",
     "value": "7KTHMC"
    },
    "FormOfPayment": [
     {
      "value": "Cash"
     }
    ],
    "TicketSegment": [
     {
      "@type": "TicketSegment",
      "sequence": 1,
      "ClassOfService": "T",
      "FareBasisCode": "TYS0BALA",
      "Status": "OpenForUse",
      "Carrier": "AF",
      "Number": "1437",
      "Departure": {
       "@type": "Departure",
       "location": "AMS",
       "date": "2024-07-16",
       "time": "15:45:00"
      },
      "Arrival": {
       "@type": "Arrival",
       "location": "CDG",
       "date": "2024-07-16",
       "time": "17:05:00"
      },
      "TicketBaggage": {
       "@type": "TicketBaggage",
       "quantity": 0
      }
     }
    ],
    "TicketPrice": {
     "@type": "TicketPrice",
     "fareCalculation": "G",
     "CurrencyCode": {
      "value": "EUR"
     },
     "Base": 61,
     "Taxes": {
      "@type": "TaxesDetail",
      "TotalTaxes": 72.28,
      "Tax": [
       {
        "currencyCode": "EUR",
        "taxCode": "YR",
        "value": 2
       },
       {
        "currencyCode": "EUR",
        "taxCode": "CJ",
        "value": 17.08
       },
       {
        "currencyCode": "EUR",
        "taxCode": "RN",
        "value": 24.15
       },
       {
        "currencyCode": "EUR",
        "taxCode": "VV",
        "value": 29.05
       }
      ]
     },
     "Total": 133.28
    },
    "PassengerTypeCode": "ADT",
    "ValidatingCarrier": "057",
    "PricingType": "Auto Priced",
    "AgencyInfo": {
     "ticketedDate": "2024-06-26",
     "name": "MARCO ET VASCO",
     "ticketingPCC": "680I",
     "code": "2026159",
     "ticketingCountry": "FR",
     "ticketingCity": "PAR"
    }
   }
  ]
 }
}