PNR Retrieve

While retrieving a PNR is not a required step in the AirReservation workflow, you should retrieve the PNR after booking to verify details. You may also need to retrieve a PNR before other actions such as ticketing, or after a booking has been ticketed.

For objects in the request and response, see the AirReservation API Reference.

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:

Ticketless Carriers Note

The following are returned in the PNR retrieve for ticketless carriers Frontier (F9), Spirit (NK), and Sun Country Airlines (SY):

  • Fare details including total fare, fare remarks, and OSI OTHS remarks.
  • The single ticket number for all travelers.

In both cases, the PNR includes this information only once it is returned from the airline, which may be delayed for several hours after booking.

Requests

PNR Retrieve Request

To retrieve a PNR, send a GET request that includes the PNR to retrieve; there is no message payload.

Get reservations/{PNR}

Base path:

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

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

Requesting Fare Rules

As the first of several efforts to support fare rules in the PNR retrieve, AirReservation20.9.1 and later allow you to request the return of long fare rules in the PNR response.

To request long fare rules, add the following to the header of your retrieve request:

“fareRuleRetrievalType”:”long”,

The response returns fare rules in the existing TermsAndConditionsFull object in a TextBlock object with the following:

  • description: For fare rules this value is FARE RULES.
  • title: Key for numbered ATPCo fare rule category/paragraph, e.g. 16. PENALTIES.
  • id: The Terms and Conditions object section number (not the ATPCo fare rule category number).
  • TextFormatted object: Contains several instances of the value attribute, which provides the text string description from the fare rules.

Complex international itineraries may not provide a complete fare rule description.

Fare rules may not be returned for offers with multiple passengers and/or multiple fare rule types.

Responses

PNR Retrieve Response

The information returned in the PNR Retrieve response can vary considerably. Factors include whether the PNR has been ticketed yet, the information provided in the reservation workflow, and whether the reservation was created outside of the Travelport JSON APIs (supported only for AirTicketing 20.9.4 and later). Generally, the PNR Retrieve returns:

  • An Offer object with the original Offer identifier provided in the reservation workflow. If seats were booked on one or more flights, an additional instance of Offer returns the booked seat for each flight in Offer/Product/Ancillary/FlightRef/SeatAssignment/Seat.
  • A Product object listing all flights and details for each flight.
  • A PassengerFlight object listing type of passengers and number of each PTC, along with class of service, fare basis, and brand details for each segment.
  • A Price object with price details for each PTC.
  • FareKey/FlightRefs contains information that can be used to retrieve seat maps.
  • A Traveler object listing each traveler and details such as name, contact information, travel document, loyalty numbers, etc. depending on the information provided at booking.
  • A FormOfPayment object listing all forms of payment used for the booking.
  • ReservationComment: Any remarks made at reservation.
  • PrimaryContact: The primary contact for the reservation, if sent as a Primary Contact remark.
  • Receipt: A confirmation with the PNR Locator (returned in Receipt/Confirmation/Locator @value) and statuses for each flight booking. If the itinerary has been ticketed, an additional instance of Receipt with the ticket number is returned).
  • ReferenceList: Any details consolidated across common objects, such as terms and conditions that apply to multiple segments.

See the AirReservation API Reference for details on all objects returned.

PNR Retrieve for Ticketed Itineraries

When a PNR has already been ticketed, either PNR Retrieve or the TicketDisplay request can be used to display ticket details. TicketDisplay returns the single ticket number sent in the request and returns basic itinerary, price, and ticketing details. PNR Retrieve lists all travelers on a PNR and has details from the booking workflow, including offer and traveler reference.

PNR Retrieve for a Ticketed Itinerary with Status

The table below lists the possible ticket statuses in Receipt/Document @type.

Ticket Status

Dcoument @type value in PNR Retrieve response

Open

DocumentTicket

Exchanged

DocumentTicketExchanged

Refund cancelled

DocumentTicket

Refund

DocumentTicketRefund

Void / Void of exchange

DocumentTicketVoid

No cancel refund

DocumentTicket

Non reportable refund

DocumentTicketRefund

PNR Retrieve with Booked Seat

The PNR retrieve returns booked free seats in a second instance of Offer that includes the selected SeatAssignment.

PNR Retrieve for Multiple One-Way Offers (NDC only)

For NDC content only, you can combine multiple one-way offers into a single PNR.