JSON APIs Getting Started Guide

This guide links to the resources you need to get started using the JSON APIs to develop your travel applications.

In this guide:

Provisioning

Travelport provides the credentials required for the JSON APIs at provisioning. You can then use the credential access manager to create and manage those credentials.

If you aren't a current Travelport customer, send a Sales Inquiry form to learn more about our products.

Authentication and Authorization

The JSON APIs use OAuth 2.0 for authentication. You must send the credentials provided at provisioning to generate an authorization token to send in all subsequent API requests. A new auth token is required every 24 hours. See Authentication for details and endpoints.

Developer Toolkits

The developer toolkits for each API provide download files with supporting artifacts, including a Postman collection to view saved requests and responses and test your own data:

Concepts and Terms

The guide topics for the APIs provide business usage details. The main guide for each API is the best starting point to learn about the terminology used in the travel industry and how that API works:

Air and Hotel have several additional guides that cover separate functional areas of the API, such as search, booking, and ticketing for flights. Every guide has a Concepts and Terms section with relevant terminology for that area.

For flights, be sure to read the Air Search Guide. All linked JSON API workflows start with the Search API, so you'll see the search concepts and example code patterns in that guide throughout the rest of the Air API.

For a list of both travel terminology and terms specific to JSON API concepts, see the glossary for each API.

Endpoints and API References

While the Guides provide general usage information, every API has complete API references that provide all of the following in the same format:

  • Reference tables detailing every object in the request and response

  • Example request

  • Example response

Each API also has a consolidated list of all endpoints and supported methods:

Headers, Errors, Troubleshooting, and Support

Most other resources you need are on the General menu at the top of every page in this help, including:

  • Common headers: The values every API request must pass in its header:

  • Error messaging: Error message formats and a list of error messages returned (not available for Pay):

  • Transaction and Trace IDs: System-generated and custom values for tracking transactions in case you need to contact support.