# Flights API Endpoints

This topic provides a consolidated list of endpoints and associated methods for all v11 Flights APIs.

See [Common Headers](/docs/flights/general/common-flights-api-headers) for the header parameters to send with all Air requests.

See the individual API References for query parameters and payloads.

## Authentication

All Travelport TripServices APIs require authentication with OAuth 2.0. Before calling any API, you must follow an OAuth-based authorization procedure to obtain an access token. That access token is valid for 24 hours and must be sent with every call during that time. Do not request a new token for each API call. See [Authentication](/docs/getting-started/authentication) for full details.

Use these endpoints for authentication requests:

> *Pre-production* https://auth.pp.travelport.net/oauth/token
*Production* https://auth.travelport.net/oauth/token


## Base Path for Flights APIs

Every TripServices API requires a request sent to an authorization endpoint unique to that API. This unique endpoint is listed at the top of every API Reference in this online help. In addition, this topic provides a consolidated list of all endpoints.

The beginning string of these endpoints are the same across almost all Flights APIs, and is called a *base path* because it is shared across APIs. The following are the current, [post-migration](/docs/getting-started/authentication#endpoint-migration) base paths for the TripServices Flights API endpoints.

**Base path:**

*Pre-production* https://api.pp.travelport.net/11/air/

*Production* https://api.travelport.net/11/air/

Combine the appropriate base path with the Flights API authorization endpoints in the next section. For example, the complete [post-migration](/docs/getting-started/authentication#endpoint-migration) endpoint for the Search API in the production environment is

> https://api.travelport.net/11/air/catalog/search/catalogproductofferings


The following TripServices APIs do not include */air* in their base path, generally because they can also be used for non-air content, as noted below  and in their API References: Cancel Workbench Items, Document History, Document List, Batch Void, and the GDS Exchange APIs. messages.

## TripServices Flights API Endpoints

### Search

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Search
 | POST catalog/search/catalogproductofferings
When sending a [flex search request](/docs/flights/guides/flights-search-guide#premium-flex-search), append /premiumflex to the endpoint above
 |
| Next Leg Search
 | POST catalog/search/catalogproductofferings/buildnext
When sending a [flex search request](/docs/flights/guides/flights-search-guide#premium-flex-search), append /premiumflex to the endpoint above
 |
| Flight Specific Search (both reference and full payload)
 | POST catalog/search/catalogproductofferings/buildoptions
When sending a [flex search request](/docs/flights/guides/flights-search-guide#premium-flex-search), append /premiumflex to the endpoint above
 |
| Air Availability | POST search/airAvailability |


### AirPrice

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| AirPrice reference payload | POST price/offers/buildfromcatalogproductofferings |
| AirPrice full payload | POST price/offers/buildfromproducts |
| Autoprice / Manual Fare for unpriced segments | POST book/airoffer/reservationworkbench/{workbenchID}/offers/buildfromunpricedsegments |
| Fare display | POST air/faredisplay/fares |


### Standalone Fare Rules

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Follow-on request for standalone fare rules | GET farerule/farerules |


### Seats, Ancillaries, and EMDs

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Ancillary search | POST ancillaryshop/catalogofferingsancillaries |
| Ancillary price | POST ancillaryprice/offers/buildancillaryoffersfromcatalogofferings |
| Seat map (reference payload) | POST search/seat/catalogofferingsancillaries/seatavailabilities |
| Standalone seat map (full payload) | POST search/seat/catalogofferingsancillaries/seatavailabilities |
| Seat/ancillary book  (add seat or ancillary to workbench) | POST book/airoffer/reservationworkbench/{workbenchID}/offers/buildancillaryoffersfromcatalogofferings |
| Cancel seat or ancillary | POST book/airoffer/reservationworkbench/{workbenchID}/offers/canceloffer |
| Retrieve an EMD | GET emds/{EMDNumber} |
| Void an EMD | PUT emds/{EMDNumber} |


### AirReservation (workbench and booking flow)

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

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Create a workbench for a new reservation | POST book/session/reservationworkbench |
| Create a post-commit workbench to update or ticket an existing reservation | POST book/session/reservationworkbench/buildfromlocator?Locator={LocatorCode} |
| Cancel workbench Items (cancels a booking, or removes only specified offers, segments, etc. from a booking or from the workbench)
 | POST book/reservationworkbench/{workbenchID]}/reservations/cancelitems
The base path varies from most TripServices APIs and does not use */air*; see Cancel Workbench Items.
 |
| Retrieve workbench details | GET book/session/reservationworkbench/{workbenchID} |
| Commit the workbench | POST book/reservation/reservations/{workbenchID} |
| Discard workbench | DEL book/session/reservationworkbench/{workbenchID} |
| Add offer to workbench - reference payload | POST book/airoffer/reservationworkbench/{workbenchID}/offers/buildfromcatalogofferings |
| Add offer to workbench - full payload | POST book/airoffer/reservationworkbench/{workbenchID}/offers/buildfromproducts |
| Add unpriced segment to workbench | POST book/airoffer/reservationworkbench/{workbenchID}/offers/unpricedsegments |
| Autoprice / Manual Fare for unpriced segments | POST book/airoffer/reservationworkbench/{workbenchID}/offers/buildfromunpricedsegments |
| Add a single traveler to workbench | POST book/traveler/reservationworkbench/{workbenchID}/travelers |
| Add multiple travelers in one request to workbench | POST book/traveler/reservationworkbench/{workbenchID}/travelers/list |
| Copy traveler details from the host to the workbench with Host Profile Move | POST book/profile/reservationworkbench/{workbenchID}/clientprofile |
| Commit the workbench and create booking | POST book/reservation/reservations/{workbenchID} |
| Retrieve a reservation | GET book/reservation/reservations/{LocatorCode} |
| Document History | POST documents/historyThe base path varies from most TripServices APIs and does not use */air*; see Document History.
 |


### Custom Rules

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Add a custom rule to a booking | POST book/customrule/customrules/{workbenchID}?RuleRecordName={NAME} |
| Delete a custom rule from a booking | GET book/customrule/customrules?PCC={PCC}?RuleRecordSequence={XYZ} |
| Return a list of all custom rules associated with a PCC | GET book/customrule/customrules?PCC={PCC} |
| Return details of a specific custom rule associated with a PCC | DEL book/customrule/customrules?PCC={PCC}?RuleRecordName={NAME} |


### Remarks and Special Service Requests

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Add primary contact remarksSee [Remarks & Service Requests Guide](/docs/flights/guides/booking-and-reservations/remarks-and-service-requests) for details on all requests in this table.
 | POST book/primarycontact/reservationworkbench/{workbenchID}/primarycontacts |
| Delete a primary contact remark | DEL book/primarycontact/reservationworkbench/{workbenchID}/primarycontacts/{PrimaryContactID} |
| Add general and OSI remarks | POST book/remarks/reservationworkbench/{workbenchID}/reservationcomments/list |
| Add special service | POST book/specialservices/reservationworkbench/{workbenchID}/specialservices/list |
| Delete special meal | DEL book/specialservices/reservationworkbench/{workbenchID}/specialservices/{SpecialServiceID} |
| Delete multiple SSRs | DEL book/specialservices/reservationworkbench/{workbenchID}/specialservices/deletemultiple |
| Add document override remarks | POST book/documentoverride/Reservation/{workbenchID}/documentoverrides |
| Add accounting, historical, and DOCI remarks | POST book/accounting/reservationworkbench/{workbenchID}/accountings |


### Travel Agency Details

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Add, modify, or delete a travel agency corporate ID
 | POST ticket/travelagency/reservationworkbench/{workbenchID}/travelagency/addcorporatecode
PUT ticket/travelagency /reservationworkbench/{workbenchID}/travelagency/{travelagencyID}/updatecorporatecode
DEL ticket/travelagency/reservationworkbench/{workbenchID}/travelagency/{travelagencyID}/deletecorporatecode
 |
| Add travel agency details to a booking in a single payload | POST ticket/travelagency/reservationworkbench/{workbenchID}/travelagency |
| Add, modify, or delete a travel agency address on a booking
 | POST ticket/travelagency /reservationworkbench/{workbenchID}/travelagency/{travelagencyID}/updateaddress
PUT ticket/travelagency /reservationworkbench/{workbenchID}/travelagency/{travelagencyID}/updateaddress
DEL ticket/travelagency /reservationworkbench/{workbenchID}/travelagency/{travelagencyID}/deleteaddress{addressID}
 |
| Add, modify, or delete a travel agency email on a booking
 | POST ticket/travelagency/reservationworkbench//{workbenchID}/travelagency/{travelagencyID}/addemail
PUT ticket/travelagency/reservationworkbench//{workbenchID}/travelagency/{travelagencyID}/updateemail
DEL ticket/travelagency/reservationworkbench/{workbenchID}/travelagency/{travelagencyID}//deleteemail/{emailID}
 |
| Add, modify, or delete a travel agency telephone number on a booking
 | POST ticket/travelagency/reservationworkbench/{workbenchID}/travelagency/{travelagencyID}/addtelephone
PUT ticket/travelagency/reservationworkbench/{workbenchID}/travelagency/{travelagencyID}//updatetelephone
DEL ticket/travelagency/reservationworkbench/{workbenchID}/travelagency/{travelagencyID}/deletetelephone/{telephoneID}
 |


### Reservation Modify (non-air details)

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Retrieve a list of updatable items by traveler identifier | POST book/updatableItem/reservationworkbench{workbenchID}/travelerupdatableitems/buildfromtraveler |
| Update traveler information after an updatable items request | PUT book/traveler/reservationworkbench/{workbenchID}/travelers/updatefromtravelerupdateditems/{TravelerID} |
| Reservation divide | POST book/reservation/reservations/divide |


### AirTicketing

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Add form of payment | POST payment/reservationworkbench/{workbenchID}/formofpayment |
| Update form of payment | PUT payment/reservationworkbench/{workbenchID}/formofpayment/{FormOfPayment_Identifier} |
| Delete form of payment | DEL payment/reservationworkbench/{workbenchID}/formofpayment/{FormOfPayment_Identifier} |
| Add payment | POST paymentoffer/reservationworkbench/{workbenchID}/payments |
| Commit the workbench and issue ticket | POST book/reservation/reservations/{workbenchID} |
| List all tickets on a reservation | GET receipt/reservations/{LocatorCode}/receipts |
| Return ticket details for all tickets for a booking (GDS) or for a single ticket (NDC) | POST ticket/tickets/getbylocator |
| Cancel a reservation for GDS | POST receipt/reservations/{LocatorCode}/receipts |
| Void single ticket for GDS | PUT ticket/tickets/updatestatus/{ticketID} |
| Batch void multiple tickets on a GDS booking
 | POST documents/void
The base path varies from other TripServices Flights APIs and does not use */air*.
 |
| Return details for a single GDS ticket with Ticket Display  (GDS, single ticket only) | GET ticket/tickets/{ticketID} |
| Queue placement | POST queue/queue |
| List all bookings on the queue | POST queue/queue/list |
| Remove a booking from the queue | POST queue/queue/remove |


### NDC Modify, Cancel, and Exchange

| Action | Endpoint (add to [Base Path](#base-path-for-flights-apis) above) |
|  --- | --- |
| Reshop in workflow to modify booking or exchange ticket for NDC | POST change/catalogofferingsairchange |
| Reprice in workflow to modify booking or exchange ticket for NDC | POST reprice/reservationworkbench/{workbenchID}/offers/buildfromcatalogofferings |
| Modify to commit workbench to modify booking or exchange ticket for NDC | POST modify/reservations/{LocatorCode} |
| Standalone Reprice to reprice itinerary before or after price guarantee expires | POST reprice/reservationworkbench/{workbenchID}/offers/buildfromoffer |
| Refund quote when canceling and refunding NDC ticket | POST book/airoffer/reservationworkbench/{workbenchID}/offers/canceloffer |
| Cancel when voiding, canceling, or refunding NDC booking or ticket | POST receipt/reservation/{workbenchID}/receipts?OfferIdentifier={OfferID} |
| Cancel payment when voiding NDC ticket and payment but retaining segments | POST paymentoffer/reservationworkbench/{workbenchID}/payments/{paymentID} |


### GDS Ticket Exchange

Endpoints for Add FOP, Add Payment, and Workbench Commit for exchanges are the same as in [AirTicketing](#airticketing) above. See the [Exchange, Refund, and Void Guide](/docs/flights/guides/exchange-refund-and-void-guide) for usage details.

| Action | Endpoint |
|  --- | --- |
| Eligibility using either the Ticket or Locator query parameter
 | POST eligibility/ticketchangeeligibilities
The base path varies from other TripServices Flights APIs and does not use */air* at the end.
 |
| Exchange Search
 | POST exchangesearch/catalogofferingsairchange
The base path varies from other TripServices Flights APIs and does not use */air* at the end.
 |
| Add/Modify Offer reference payload
 | POST book/offer/reservationworkbench/{workbenchID}/offers/buildfromcatalogofferings
(add to [Base Path](#base-path-for-flights-apis) above)
 |