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
The Ticket Retrieve request returns details for a single ticket for NDC.
Request
Also see Authorization and Common Headers.
Query Parameters
None.
Request Body
![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)
Object |
Description |
Required/Optional |
---|---|---|
TicketQueryGetByLocator |
Top level object Includes Locator and TicketNumber. |
Required |
Locator |
Top level object for locator code. |
Required |
|
Send the reservation locator code. |
Required |
|
Send with the value Locator. |
Required |
TIcketNumber |
Top level object for ticket number. |
Required |
|
Send the ticket number. |
Required |
|
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.
![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)
Object |
Description |
---|---|
TicketListResponse |
Top level object for response. Includes the Ticket object. |
Ticket |
Contains all ticketing details. May include the following:
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:
|
ReservationLocator |
Reservation locator. Key value pairs:
|
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:
Contains CardNumber object. |
CardNumber |
Returned if payment was made by credit card. Key value pairs:
|
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:
Includes Departure, Arrival, and TicketBaggage objects. |
Departure |
Key value pairs:
|
Arrival |
Key value pairs:
|
TicketBaggage |
Any baggage that is part of the ticket. |
TicketPrice |
Ticket price details. Key value pairs:
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:
|
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:
|
FlightProduct |
Class of service and fare code details for each flight in the itinerary. Key value pairs:
|
Example Request
![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)
{
"TicketQueryGetByLocator": {
"Locator": {
"value": "7KPPBF",
"locatorType": "Locator"
},
"TicketNumber": [
{
"value": "0572317564374",
"contentSource": "NDC"
}
]
}
}
Example Response
![Closed](../../../Skins/Default/Stylesheets/Images/transparent.gif)
{
"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"
}
}
]
}
}