canonical: https://jentic.com/apis/kiwi.com/kiwi

# Kiwi Tequila API

The Kiwi Tequila API searches flights and books them programmatically. It finds one-way, return, and multi-city itineraries, resolves airports and cities, rechecks fares before purchase, saves a booking, and confirms payment against Kiwi.com's travel inventory. Requests and responses are JSON, so an agent can search fares, assemble an itinerary, and complete a booking end to end.

## For AI agents

Search one-way, return, and multi-city flights, resolve airports and cities, and complete bookings through recheck, save, and payment steps.

## Scope

Does not book hotels, cars, or ground transport, and does not manage loyalty programs; use it for flight search and booking only.

## Capabilities

- Search one-way and return flights by route and date
- Search multi-city itineraries in a single request
- Look up airports and cities by name or by radius
- Recheck fare and availability before booking
- Save a booking for selected flights
- Confirm payment to complete a booking

## Use cases

### Search and compare fares

Trip planning starts with finding flights that fit dates, budget, and routing. The Kiwi Tequila API searches one-way, return, and multi-city itineraries and returns priced options, so a travel tool can present fares without maintaining its own flight inventory. Results include the booking tokens needed to continue to purchase.

Example prompt: Search flights between two cities for a given date range and return the lowest-priced options.

### Resolve locations for search input

Users describe trips by city name, not airport code. The Kiwi Tequila API resolves place names to airports and cities and finds locations within a radius, so an application can turn free-text input into the identifiers a flight search needs. Location lookup supports both query and radius forms.

Example prompt: Resolve a user's typed city name to the matching airport identifiers before running a flight search.

### Complete a booking

Turning a chosen fare into a confirmed trip requires rechecking price, saving the booking, and paying. The Kiwi Tequila API rechecks flights, saves a booking, and confirms payment in sequence, letting an application carry a customer from selection to confirmation. Fares can change between search and purchase, so the recheck step guards against stale prices.

Example prompt: Recheck a selected fare, save the booking, and confirm payment to finalize the trip.

### Agent-driven trip booking

An AI travel agent can plan and book a trip for a user without a developer wiring each call. Through Jentic the agent matches an intent such as 'book a flight to Berlin next Friday' to the Kiwi search and booking operations, runs them in order, and reports the confirmation. The API key stays in the user's Jentic One instance and never reaches the agent's prompt.

Example prompt: Search flights for a requested route and date, recheck the best fare, and complete the booking on the user's behalf.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | `/v2/search` | Search one-way and return flights matching route and date criteria. |
| POST | `/v2/multicity` | Search multi-city itineraries in a single request. |
| GET | `/locations/query` | Look up airports and cities by name. |
| GET | `/v2/booking/check_flights` | Recheck price and availability before booking. |
| POST | `/v2/booking/save_booking` | Save a booking for the selected flights. |
| POST | `/v2/booking/confirm_payment` | Confirm payment for a saved booking. |

## Key resources

- **Flight search** — Search one-way, return, and multi-city flights by route and date.
- **Locations** — Look up airports and cities by query or radius.
- **Booking** — Recheck fares, save bookings, and confirm payment.

## Why Jentic

- **Setup:** Wiring Kiwi Tequila yourself means managing an API key header, carrying booking tokens between search, recheck, save, and payment calls, and handling fares that change between steps. With Jentic you install once, import Kiwi Tequila from the API Directory, and store the key a single time.
- **Permission scoping:** Jentic lets you grant your agent only the operations it needs, such as flight and location search without save-booking or payment confirmation, and enforces that on every call.
- **Credential handling:** Your Kiwi Tequila API key is stored once, encrypted, by your own Jentic One instance. It is injected when a call runs and never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents find Kiwi Tequila through Jentic's intent search, matching a request like 'find flights to Berlin' to the right operation without hardcoded endpoints.

## Related APIs

- **Amadeus** — Global travel platform API for flights, hotels, and fares.
- **Flightradar24** — Live flight tracking and status data.
- **Wink** — Travel distribution API for hotel and accommodation inventory.

## FAQ

### What can an AI agent do with the Kiwi Tequila API through Jentic?

An agent can search one-way, return, and multi-city flights, resolve airports and cities, recheck fares, and complete a booking through save and payment steps. Through Jentic the agent matches an intent to the right operation and runs it with your API key injected at execution time.

### How do I authenticate with the Kiwi Tequila API?

Kiwi Tequila authenticates every request with an API key sent in the `apikey` header. You store the key once in your Jentic One instance, and it is added to each call at run time rather than exposed to the agent.

### Can prices change between searching and booking?

Yes. Fares and seat availability can shift after a search, which is why the API includes a check-flights step to revalidate price and availability before you save a booking and confirm payment. Run that recheck immediately before purchase.

### Does the Tequila API document rate limits?

The OpenAPI specification does not state rate limits; request allowances depend on your Tequila partner tier. Check the limits for your account in the Tequila partner portal and documentation at https://tequila.kiwi.com.

### Can I limit what my agent is allowed to do with the Kiwi Tequila API?

Yes. Jentic lets you allow only the operations your agent needs, for example flight and location search while withholding save-booking and payment confirmation. Your Jentic One instance enforces that boundary on every call and keeps the API key outside the agent's context.