Install Jentic One Beta

Connect the Kiwi Tequila API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Kiwi Tequila API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fkiwi.com%2Fkiwi" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fkiwi.com%2Fkiwi" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with Kiwi Tequila API.

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

GET STARTED

Start building with Kiwi Tequila API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Kiwi Tequila API for, with concrete tasks.

★ 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.

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.

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.

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.

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

Key Endpoints

7 endpoints — the kiwi tequila api searches flights and books them programmatically.

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.

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.

Why Jentic?

What agents get from Jentic-routed access to this vendor.

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 isolation

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.

Intent-based discovery

Agents find Kiwi Tequila through Jentic's intent search, matching a request like 'find flights to Berlin' to the right operation without hardcoded endpoints.

FAQs

Specific to using Kiwi Tequila API through Jentic.

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.

Kiwi Tequila API

Name: Kiwi Tequila API
Brand: Kiwi Tequila API
Availability: InStock

Official vendor OpenAPI document · agent-readyE CommerceOrder ManagementapiKey7 EndpointsREST

For Agents

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

Use for: I need to find flights between two cities on a date, Search a multi-city trip across several destinations, Look up the airport code for a city, Check whether a flight's price is still valid

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

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.

Jentic One on Github View OpenAPI Document

Connect the Kiwi Tequila API to your agent

Capabilities

Start building with Kiwi Tequila API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Kiwi Tequila API