Developer Hub

Try our Rapid SDK in Java! It simplifies onboarding and gets you using Rapid faster.

Getting started with Rapid API

Set up Rapid API yourself or work with a certified third-party partner to launch your customized travel site

Set up your Rapid API implementation

As with any API, you'll need to do some prep work before you can use the Rapid APIs.

Step 1: Become a partner

To integrate with Rapid API, you need to apply to become a partner if you aren’t one already.

Step 2: Review the applicable launch requirements

Review the launch requirements for the APIs you're planning to implement to decide which requirements will require front end user interface development so that you can factor it into your project planning.

Step 3: Prepare your environment

Review the documentation for each API you plan to implement to prepare your environment for using Rapid.

Step 4: Get credentials and configure for authentication

Once you have become a partner and been approved to integrate with Rapid API, you will need to obtain your API key. You can do this by logging into the Portal and clicking Connectivity in the menu bar on the left. Then select API key from the options. You will also need your shared secret, which you can access by going into the Portal and navigating to the API Keys page. Your API key will be in a restricted development mode until after your site review, when you have been approved for launch to a production environment.

To make a request to our API service, whether in test or production, you'll use the HTTP authorization header to transmit your API key and an SHA-512 signature hash with each request. The SHA-512 hash consists of your shared secret, your API key, and a current UNIX timestamp. Authorization headers for Rapid API always use the following format:

Authorization: EAN APIKey=yourAPIKey,Signature=sha512Hash,timestamp=yourUNIXTimestamp

Step 5: Begin testing your requests

Once you have received your credentials and configured for authentication, you can start making requests against our testing endpoint, https://test.ean.com/. Any booking requests made against https://test.ean.com/ will not result in actual property reservations or credit card charges. You can choose from each API's documented test headers to control what type of response you want to see. If you omit a test header for any booking-related request, the test server will add one for you.

Use the servers.url value in the OpenAPI spec to construct your URL. Validation testing should use test.ean.com, and api.ean.com is the production endpoint. Preserve the protocol and path when switching between endpoints.

https://test.ean.com/v3/itineraries?…
https://api.ean.com/v3/properties/22135/payment-options?token=U1dFC0JHTW

The servers.url value is found at the top of our downloadable OpenAPI spec files and will always correspond with the version number for the given API service.

Note for the Rapid Lodging API: To ensure we deliver a stable and maintainable service, we apply rate limits. The system monitors anomalous API traffic and will take action to protect itself automatically. Before making any planned changes to the behaviour of calling the API, or conducting performance tests with API access, make sure to review your plans with your Rapid API consultant.

Step 6: Request a site review

Once you’re comfortable with your integration and have confirmed you meet the applicable launch requirements, ask your business development manager for a site review. When you're approved to go live, your business development manager will enable your API key for production use. Then you'll switch your request endpoints from https://test.ean.com/ to https://api.ean.com and continue making requests. No additional code changes are required.


Warning

Warning

If you receive 403 Forbidden responses after switching to https://api.ean.com, alert your business development manager and ask them to verify that your API key is enabled for the production endpoint. Rapid will not authorize a development API key for our production endpoint.

Work with one of our certified tech partners

Prefer to outsource your Rapid Lodging API development? You can work with one of our Elite and Preferred technology partners, who can design, build, and optimize your integration so you can go live faster with less in‑house development.

Explore our Certified Technology Partners Program

Did you find this page helpful?
How can we improve this content?
Thank you for helping us improve!