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/

Related Content: NDC Modify, Cancel, and Exchange Guide

NDC only. To retrieve a GDS ticket use the Ticket Retrieve API.

The Ticket Retrieve request returns details for a single ticket for NDC.

For differences in support between GDS and NDC in the JSON APIs, see the support tables for seats, ancillaries, fare rules, and exchanges. Also see the NDC Carrier-Specific Notes and the NDC and GDS Functionality Comparison Chart.

For carrier-specific NDC differences, see NDC capabilities by airline through JSON API in the Travelport Knowledge Base. If you need login assistance, see Knowledge Base NDC Resources.

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 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, and agency information. Not all details may be returned if not part of the booking 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 of the itinerary. Multiple instances are returned for itineraries with more than one leg, such as round-trip or multi-city. 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 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 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. 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"
    }
   }
  ]
 }
}