All Air APIs Endpoints

This topic provides a consolidated list of endpoints and associated methods for all v9 Air APIs. For links to all topics see the API Reference List.

See Common Air API Headers for the header fields that must be sent with all Air requests.

In this topic:

Authorization

For authorization tokens, send your request to the following endpoint as appropriate:

Pre-production: https://oauth.pp.travelport.com/oauth/oauth20/token

Production: https://oauth.travelport.com/oauth/oauth20/token

Base Path

Use the following base path for all air endpoints, either pre-production or production as appropriate. Production endpoints can be used only after you are provisioned.

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

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

You must send your request to the correct version of the API you are using - check the version in the URL of the endpoint, and make sure it matches the version indicated in your message headers.

AirSearch

Action

Endpoint (add to Base Path above)

All AirSearch requests

POST search/catalogofferings

Pagination requests

GET search/catalogofferings/search/catalogofferings/{identifier}

AirPrice

Action

Endpoint (add to Base Path above)

Reference payload price request

POST price/offers/buildfromcatalogofferings

Full payload price request

POST price/offers/buildfromproducts

Full Brand Pricing

Action

Endpoint (add to Base Path above)

Price follow-on request for full brand pricing

POST brandfullinfo/brands/buildcompleteinfofromoffer

Remarks

Action

Endpoint (add to Base Path above)

Add primary contact remarks

POST book/primarycontact/reservationworkbench/{workbenchID}/primarycontacts

Add general and OSI reservation comment remarks

POST book/remarks/reservationworkbench/{workbenchID}/reservationcomments/list

Add SSR disability remarks

POST book/specialservices/reservationworkbench/{workbenchID}/specialservices/list

Add back office remarks

POST book/backoffice/reservationworkbench/{workbenchID}/backoffices

Seats

Action

Endpoint (add to Base Path above)

Return a seat map for the specified segment

POST search/seat/catalogofferingsancillaries/seatavailabilities

Add a seat selection to the reservation workbench

POST book/ancillary/reservationworkbench/{workbenchId}/offers/buildancillaryoffersfromcatalogofferings

AirReservation

For {workbenchID, send the workbench identifier returned when the workbench was created. For {PNR} send the PNR locator code. For {ticketID} send the ticket number. For {OfferID} send the offer identifier.

Action

Endpoint (add to Base Path above)

Initiate a workbench for a new reservation

POST book/session/reservationworkbench

Discard workbench

DEL book/session/reservationworkbench/{workbenchID}

Retrieve workbench details

GET book/session/reservationworkbench/{workbenchID}

Add offer to the reservation workbench using the reference payload request

POST /buildfromcatalogofferingsbook/offer/reservationworkbench/{workbenchID}/offers

Add offer to the reservation workbench using the full payload request

POST /buildfromproducts/offer/reservationworkbench/{workbenchID}/offers

Add traveler to the reservation workbench

POST book/traveler/reservationworkbench/{workbenchID}/travelers

Commit the workbench

POST book/reservation/reservations/{workbenchID}

Retrieve the PNR

GET book/reservation/reservations/{PNR}

AirTicketing

Action

Endpoint (add to Base Path above)

Queue placement

POST queue/queue

Initiate a post-commit workbench to update or ticket an existing reservation

POST book/session/reservationworkbench/buildfromlocator?Locator={PNR}

Add form of payment

POST payment/reservationworkbench/{workbenchID}/formofpayment

Add payment

POST paymentoffer/reservationworkbench/{workbenchID}/payments

Issue ticket

See Commit the workbench above in AirReservation.

List all tickets on a PNR

GET receipt/reservations/{PNR}/receipts

Cancel a PNR for GDS

POST receipt/reservations/{PNR}/receipts

Cancel a PNR or a ticket for NDC

POST receipt/reservations/{workbenchID}/receipts?OfferIdentifier{OfferID}

Void ticket for GDS

PUT ticket/tickets/updatestatus/{ticketID}

Return details for a single ticket

GET ticket/tickets/{ticketID}