v1

latestOpenAPI 3.0.02026-08-061029011.1 MB

Retrieve Bookings and Tickets

Reservation Retrieve

Retrieve details about a held booking or PNR.
While a PNR refers to a held booking that has not been ticketed, the PNR code persists after ticketing to provide the booking records. If the booking has been ticketed, Reservation Retrieve returns booking, payment, and ticketing details.

Reservation Retrieve returns air, hotel, and/or car segments for any reservation that includes that content, called a multi-content booking. All segments must have been booked with the TripServices Flights APIs, TripServices Stays APIs, TripServices Car APIs (release pending), or a Travelport+ terminal program. You can add either GDS or NDC air offers to a hotel and/or car booking, but not both. See the Multi-content Booking Guide (Air, Hotel, Car) for workflows and examples.

The TripServices Flights APIs provide the following APIs to retrieve bookings and tickets:

To retrieve all booking details, use Reservation Retrieve. Returns all booking, payment, and ticketing information currently on a booking.
To retrieve a ticketed itinerary from a ticket number, use Ticket Display.
To retrieve a list of all ticket numbers on a booking, use Ticket List.
To retrieve details for all tickets associated with a booking (GDS only), or for a single ticket for NDC, use Ticket Retrieve.
To return a list of documents on a booking, such as tickets, invoices, MCOs, and EMDs, use Document List.
To return histories of up to six documents on a booking, such as tickets, invoices, MCOs, and EMDs, use Document History.

get/air/book/reservation/reservations/{Identifier}

Path parameters

Identifierstring required

Example:DVZJ8M

The Reservation Identifier or Record Locator for the Reservation you wish to retrieve.

Query parameters

authoritystring

Example:TVPT

The authorizing entity creating the identifier

detailViewIndboolean

The detail view returns any document override, accounting, historical, and DOCI remarks added to the booking, and any custom rules added to a booking.

If true: Returns detail view.
If false (default behavior): Does not return detail view.

viewBrandCompleteInfoIndboolean

GDS only; not supported for NDC.
Request the return of brand attributes in the reservation retrieve.

If true: Returns complete information for brand attributes in Offer/Product/PassengerFlight/FlightProduct/Brand.
If false (default behavior): Does not return brand attributes.

viewBaggageDetailIndboolean

GDS only; not supported for NDC.
Request the return of baggage dimension and fee details in the reservation retrieve.

If true: Returns additional baggage details in TermsAndConditionsFull/BaggageAllowance.
If false (default behavior): Does not return baggage details

identifierType'Reservation' | 'Locator' | 'SupplierLocator' | 'DocumentNumber'

Example:Locator

The type of identifier key used to retrieve the reservation.
Typically sent as 'Locator' with Identifier as the Locator Code (PNR) to retrieve booking information.

documentType'EMD' | 'MCO' | 'Ticket' | 'TASF' | 'Invoice'

Document type like EMD, MCO

Example:Ticket

When DocumentNumber is selected in identifierType, use documentType to identify the type of document.

includeFlightAmenitiesIndboolean

Request the return of additional flight amenities, provided by ATPCO as RouteHappy data.

If true: Returns flight amenity data in ReferenceList/ReferenceListAmenity.
If false (default behavior): Does not return flight amenity data.

retrieveNonGDSSourceReservationIndboolean

If true, reservation information will be retrieved directly from the source supplier.

Headers

TraceIdstring

Example:TraceID_123456789

Identifier used to correlate Air API invocations across a multi-call business flows.

XAUTH_TRAVELPORT_ACCESSGROUPstring

Example:19Y88702-C27A-4E5D-829A-89D7016688B1

Identifies the Travelport access group with which the caller is associated

travelportPlusSessionIdentifierstring

Example:49f58f5f-c443-43b4-9f5d-be405fd00a01

travelportPlusSessionIdentifier used to maintain an established agency session

TVP-PCC-Corestring

Example:DU7_1G

Allows user to pass PCC instead of Access Group ID

Response

OK - Successful Response - 200

Example response

{
  "ReservationResponse": {
    "Reservation": {
      "@type": "Reservation",
      "id": "REF12873",
      "Identifier": {
        "value": "A0656EFF-FAF4-456F-B061-0161008D7C4E",
        "authority": "TVPT"
      }
    },
    "@type": "response",
    "transactionId": "49f58f5f-c443-43b4-9f5d-be405fd00a01",
    "traceId": "TraceID_123456",
    "Result": {
      "@type": "Result",
      "status": "Complete",
      "Error": [
        {
          "@type": "ErrorDetail",
          "StatusCode": 200,
          "Message": "No flights found.",
          "NameValuePair": [
            {
              "value": "Sunday",
              "id": "6",
              "name": "Day1"
            }
          ]
        }
      ],
      "Warning": [
        {
          "@type": "WarningDetail",
          "StatusCode": 200,
          "Message": "Customer Loyalty could not be applied.",
          "NameValuePair": [
            {
              "value": "Sunday",
              "id": "6",
              "name": "Day1"
            }
          ]
        }
      ]
    },
    "Identifier": {
      "value": "A0656EFF-FAF4-456F-B061-0161008D7C4E",
      "authority": "TVPT"
    },
    "NextSteps": {
      "id": "5",
      "NextStep": [
        {
          "value": "www.resourcelocation.com",
          "id": "2",
          "action": "cancel",
          "description": "remove offer from the order"
        }
      ]
    },
    "ReferenceList": [
      {
        "@type": "ReferenceListFlight"
      }
    ],
    "CurrencyRateConversion": [
      {
        "SourceCurrency": {
          "value": "USD",
          "codeAuthority": "ISO 4217",
          "decimalPlace": 4,
          "decimalAuthority": "ISO 4217"
        },
        "TargetCurrency": {
          "value": "USD",
          "codeAuthority": "ISO 4217",
          "decimalPlace": 4,
          "decimalAuthority": "ISO 4217"
        },
        "ConversionRate": {
          "rateAuthority": "ISO 4217",
          "rateAsOf": "2026-08-07T12:12:00Z"
        }
      }
    ],
    "Pagination": {
      "@type": "Pagination",
      "page": 1,
      "pageSize": 20,
      "totalPages": 5,
      "totalItems": 100
    }
  }
}