Booking API
One API for flights, hotels and fixed fares: what a single integration gives you
By Idea Holiday team · Updated 26 Oct 2026 · 3 min read
A travel business that wants to sell flights, hotels and fixed-departure fares usually faces three separate integrations: different formats, different payment routes and different ways of failing. The Idea Holiday Partner API puts the three products behind one key, one response format and one wallet. This guide explains what that gives you.
What you can reach
- Flights from 700+ airlines.
- Hotels: 10M+ hotels.
- Fixed-departure fares, sold alongside flights and hotels.
- All of it supplied through 500+ suppliers added for flights, hotels and fixed fares, and growing.
One key, three products
You search and book hotels, flights and fixed-departure fares through the same API with your own key. Each key is enabled for certain products, so a key without hotel access gets a clear refusal on hotel calls. You can lock a key to your own server IP addresses. A test key lets you build safely, and a live key is used for real bookings.
One response format
Every answer has the same envelope: a request ID, a status, the data, a list of errors with a code and a message, and meta with the currency. All amounts are in INR. Quote the request ID when you contact support, and your team and ours are looking at the same call.
One payment route
Bookings are paid from your agent wallet. You can spend your wallet balance plus your credit limit. The hotel price or the fare is debited when you book, and if the hotel or the airline refuses the booking, the price is refunded to your wallet.
Retries that cannot double-book
Every booking request carries an Idempotency-Key header. If a request times out and you send it again with the same key and the same body, you get the first answer back and nothing is booked twice.
Events instead of polling
Set one https address for webhooks and choose your events. You are told when a booking is confirmed, ticketed, failed or cancelled, when an airline changes a fixed-fare PNR, and when your available funds fall below an amount you set. Events are signed, so your server can check that they came from us.
Limits you can plan around
By default each key is limited to 120 requests a minute and 5,000 searches a day, counted in UTC. Ask Idea Holiday if you need higher limits.
Common questions
- Do I need a separate key for each product?
- No. One key can be enabled for hotels, flights and fixed fares. A key without access to a product is refused on that product only.
- Are amounts always in rupees?
- Yes. All amounts in the Partner API are in INR.
- How do I get access?
- Register, verify your business with your PAN, then apply for API access in your account. Our team approves the request and you create your keys there.