Frequently Asked Questions

This FAQ provides answers to basic questions about Despegar Api.
Check out our how to section to start using it.

General Questions

  1. What is an API Key and do I need it?

Answer: An application programming interface key (API key) is a code passed in by computer programs calling an API (application programming interface) to identify the calling program, its developer, or its user to the Web site. API keys are used to track and control how the API is being used, for example to prevent malicious use or abuse of the API (as defined perhaps by terms of service). The API key often acts as both a unique identifier and a secret token for authentication, and will generally have a set of access rights on the API associated with it. API keys can be based on the UUID system to ensure they will be unique to each user.

  1. What are other advantages of using an API?


  • The information returned is always fresh from the database.
  • The only maintenance needed for a live Web Services site is to update any new options available to you in the API, or on occasion, when our API has been modified to improve overall data integration.
  • With less maintenance of content, you are free to focus and spend more time on:
    ° Marketing
    ° Targeted Traffic
    ° Improving conversion ratios
  1. How do I get a production key/access to production?

Answer: For a productive api key you have to follow the steps we indicate in the following link.

  1. Who can be integrated via API?

Answer: If you have an online travel agency, a metasearch site, a travel management company, a startup or a company wanting to integrate travel into your application.

  1. What are you need to integrate API?


  • You need to understand programming and scripting languages using the Internet.

  • You need have the means or resources to develop or hire developers, if you don´t have

  • APIs require maintenance. You must continually update your code and monitor its efficiency.
    ° If system updates take place and required code modifications are not made, features on your site may not work correctly or not display at all.

  • You are responsible for all your own programming, application logic, debugging, and server monitoring, etc.

  • When using the data interface, a request for “raw” data is made and a “raw” data response is returned.
    ° This means that you are required to create, program, validate, maintain, monitor, and evaluate all your own logic needed to interface between our system and the end user successfully.

  • It is an involved process which requires that you log and evaluate user activity on your website in order to optimize the site experience to your greatest advantage. This is entirely your responsibility, since we are not able to monitor your website for you.

  1. Steps to a Successful API Integration?

Step 1: The first step is to obtain the available routes. The following example searches itineraries from Buenos Aires to Miami on the site of Argentina for the date 14.08.2014 for an adult. This resource returns a summary of information for each route, enough to understand and to be able to choose between different options.

Step 2: The ability to access the next service to get a detail of the route concerned, accessing methods available and other details. There are cases in which the search result is not marked with the detail of taxes, this can also be accessed for the detailed itinerary for these values. The “itinerary_id” is obtained in the above service.

Step 3: Having chosen the route proceeds to make the reservation with the following service using the “itinerary_id” selected above. The initial state of the same NO confirms that your flight has been booked. The response they will find the information necessary to form complete in the next step.

Step 4: To complete the process, you must call one or more times in the next service “booking_id” obtained in the previous service. Initially it must provide passenger data and the method of payment, then it may happen that required having to call the service to enter data for a new payment method (if the previous one has failed) or complete some questions of risk. When more information is required by code 310 (redirect) is obtained. When all the necessary information it is complete, it will get the code 200.

Technical Questions

  1. Please define languages that your API supports?

Answer: Our API support the principal languages, Spanish, English and Portuguese.

  1. Do you have multilingual support?

Answer: Yes, we have a multilingual support.

  1. Please define communication protocol that your API works on (HTTP, FTP, NFS, etc.)?

Answer: We have an obligatory protocol, this is HTTPS.

  1. Do you have static content as file or over API? In which format do you support?

Answer: No we don’t have an static content we exposed files are dynamic services.

  1. Do you support geo-location information for all your inventory?

Answer: Yes all of our inventory have a geolocation information.

  1. Which payment options do you support?

Answer: We support a Credit Card, Bank Transfer, payment destination, prepaid.

  1. Do you have paging (pagination kind, incremental paging or full paging)?

Answer: Yes

  1. What kind of errors supports API?

Answer: We support HTTP error codes.

  1. What are the basic requirements for my application if I use API?

Answer: The basic requirements for your application are to:
Make HTTP requests

  • Parse JSON documents
  1. What tools, platforms and languages can I use with API?

Answer: You can use any language or tool of your choice, such as Java, Python, Ruby, PHP, JavaScript, etc.