{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":["img","admonition"]},"type":"markdown"},"seo":{"title":"Using the Help","description":"Create AI-native travel products with Travelport's powerful, flexible APIs.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"using-the-help","__idx":0},"children":["Using the Help"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Information about the TripServices APIs is available in this online help as either a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["guide"]},", ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API reference"]},", or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["workflow"]},". You can also use searches to help find what you need."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"guides-overview-usage-and-capability-support","__idx":1},"children":["Guides: Overview, Usage, and Capability Support"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This online help provides a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["guide"]}," for all functional areas of using the TripServices APIs to book and manage air travel. These include searching, pricing, booking, updating traveler details, and making exchanges. Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Guides"]}," menu at the top of any page for a list, or click the Guides menu heading to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/flights-guides"},"children":["see a full list"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each guide provides a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["functional overview"]}," and basic usage information for the API/s in that area. Guides define basic concepts for that travel area, such as the difference between an itinerary, leg, and segment for travel by air. Guides also include the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#workflow-diagrams-api-call-sequences"},"children":["workflow diagrams"]}," detailed below."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Guides for capabilities with variable support in the TripServices APIs provide a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["support table"]},". For example, functionality may differ between NDC and GDS, and/or be supported only in specific workflows. The ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/guides/seats-and-ancillaries/seats-guide#seats-support"},"children":["Seats support table"]}," excerpted below includes both scenarios."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/supporttable.8550f441ca1001c9da86bec2210f283d26680f4b8f2674343690c2fd80a5efb7.e1a21d9b.jpg","withLightbox":false},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most guides also include layout diagrams illustrating the basic structure of the request and response payloads for that API. Layout diagrams provide a hierarchical view of the API's high-level objects."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/layout-diagram.222b718c4fe43790d754df6fed3a583bbebb736805e3ad2f9a1a8b1c3c39c23f.e1a21d9b.jpg","withLightbox":false},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-references-technical-details-and-examples","__idx":2},"children":["API References: Technical Details and Examples"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every TripServices API has an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API reference"]},". Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["API References"]}," menu at the top of any page for a list, or click the API References menu heading to see a full list by resource."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each API reference is a ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["full technical reference"]}," for the API. It provides object-level details including supported formats and values."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All API references provide the same navigation at the top of the page, as shown to the right."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An API Reference always includes the following information in this order:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["method and endpoint"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["any query parameters"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["reference tables for the request and response"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["code examples of the request and response"]}]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/api-reference-top.05c1c696af2a122d8b3dd3b1ca541ef8b641b5ee4d0ff4e3ee5bcd2cae1e17ad.e1a21d9b.jpg","withLightbox":false},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To make it easier to navigate the page, reference tables and examples load in collapsed dropdown boxes like this:"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/drop-closed.c321bbe793e2727e07e61063b94d610a78a5499275ac68ac5d37fb65c416bdd6.e1a21d9b.jpg","withLightbox":false},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Click the heading to expand and collapse the dropdown. Use the Copy button, circled below, to copy that example so you can paste it into your own Postman collection or other application."]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/drop-expanded.e3c6f7953e18572ca6947c3f5a7bacfbf436883de49673835376db28cb5128b8.e1a21d9b.jpg","withLightbox":false},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"workflow-diagrams-api-call-sequences","__idx":3},"children":["Workflow Diagrams: API call sequences"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The TripServices APIs are linked together in ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["workflows"]}," from air shopping through booking and ticketing, with optional calls along the way. Open the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workflows"]}," menu at the top of any page, or click the Workflows menu heading to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/workflows/booking-and-ticketing/all-book-and-ticketing-workflows"},"children":["see a full list"]},". Workflow diagrams are also embedded in their associated ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#guides-overview-usage-and-capability-support"},"children":["guide"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Workflow diagrams provide a high-level overview of the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/workflows/booking-and-ticketing/all-book-and-ticketing-workflows"},"children":["entire travel booking flow"]},", as well as individual processes that require multiple API calls, such as ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/workflows/booking-and-ticketing/booking-workflow"},"children":["booking"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/flights/workflows/booking-and-ticketing/ticketing-workflow"},"children":["ticketing"]},". Diagrams can help you decide which workflow to implement in various scenarios."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"json-apis-add-product-booking-workflow","__idx":4},"children":["JSON APIs Add Product booking workflow"]},{"$$mdtype":"Tag","name":"Diagram","attributes":{"data-language":"mermaid","align":"center","diagramType":"mermaid","diagramSource":"flowchart TD\n A[\"Create\\nnew workbench\"]\n B[\"Add product\\nwith full\\nitinerary details\"]\n C[\"Add\\ntraveler/s\\n(traveler\\nremarks optional)\"]\n D[\"Standalone\\nPrice\\n(optional)\"]\n E[\"Commit\\nworkbench;\\ncreate\\nreservation\"]\n\n A --> B --> C --> D --> E\n\n","diagramHtml":"

Create
new workbench

Add product
with full
itinerary details

Add
traveler/s
(traveler
remarks optional)

Standalone
Price
(optional)

Commit
workbench;
create
reservation

","diagramHtmlDark":"

Create
new workbench

Add product
with full
itinerary details

Add
traveler/s
(traveler
remarks optional)

Standalone
Price
(optional)

Commit
workbench;
create
reservation

"},"children":["flowchart TD\n A[\"Create\\nnew workbench\"]\n B[\"Add product\\nwith full\\nitinerary details\"]\n C[\"Add\\ntraveler/s\\n(traveler\\nremarks optional)\"]\n D[\"Standalone\\nPrice\\n(optional)\"]\n E[\"Commit\\nworkbench;\\ncreate\\nreservation\"]\n\n A --> B --> C --> D --> E\n\n"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"search-tips-finding-what-you-need","__idx":5},"children":["Search Tips: Finding what you need"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you've checked the guide and the API reference for an API and/or its functional area without finding what you need, try a search at the top of any page:"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/searchbar.0a21422a89ac35043f2d1cd6e295eca4d3e06ce63b055f9c18e4aa538babe5bc.e1a21d9b.jpg","withLightbox":false},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All supported JSON objects are documented in the help. To search for technical details in the API reference, enter the exact object name; e.g., ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["combinablilitycode"]}," instead of ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["combinability code"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For terms, use quotation marks as needed, as in \"carrier support\". For example, \"round trip\" returns results with the phrase ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["round trip"]},". However, ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["round trip"]}," without quotations returns all pages that have both words (round and trip) anywhere in the page."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The search is not case-sensitive, and you can enter partial words using at least four characters. Words with variant endings are returned in results. For example, a search for ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["ticket"]}," returns topics with tickets, ticketing, and ticketed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The search supports the following symbols and Boolean operators, which are not case-sensitive:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["AND"]}," or plus (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]},") or ampersand (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["&"]},") narrows the search to only topics that contain all of the words in the same topic but not necessarily together as a phrase."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["OR"]}," a pipe (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["|"]},") broadens the results by retrieving topics that contain any of the words it separates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["NOT"]}," a caret (",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["^"]},") finds topics that contain one term but not the other."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"key-terms-notes-and-warnings","__idx":6},"children":["Key terms, notes, and warnings"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Throughout the help, the following standard formatting presents the same types of information consistently."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Important concepts are highlighted in bold coral text like this:"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the TripServices Search APIs, an ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["offer"]}," is a product available at a specific price under a set of terms and conditions. A ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["product"]}," is the flight or connecting flights for ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["one leg"]}," of the itinerary, plus a service level that includes the cabin class and any fare codes that may apply."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Informational notes are called out with a light blue background color."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Warnings about issues that can cause unexpected results or error messages are called out with a yellow background color."]}]}]},"headings":[{"value":"Using the Help","id":"using-the-help","depth":1},{"value":"Guides: Overview, Usage, and Capability Support","id":"guides-overview-usage-and-capability-support","depth":2},{"value":"API References: Technical Details and Examples","id":"api-references-technical-details-and-examples","depth":2},{"value":"Workflow Diagrams: API call sequences","id":"workflow-diagrams-api-call-sequences","depth":2},{"value":"JSON APIs Add Product booking workflow","id":"json-apis-add-product-booking-workflow","depth":4},{"value":"Search Tips: Finding what you need","id":"search-tips-finding-what-you-need","depth":3},{"value":"Key terms, notes, and warnings","id":"key-terms-notes-and-warnings","depth":2}],"frontmatter":{"seo":{"title":"Using the Help"}},"lastModified":"2026-05-27T15:34:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/flights/downloads-and-support/using-the-help","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}