Install Jentic One Beta

Connect the Duffel API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Duffel 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%2Fduffel.com%2Fduffel" | 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%2Fduffel.com%2Fduffel" | 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 Duffel API.

Create an offer request to search flight availability

Read and compare the offers returned for a search

Place an order to book a selected offer

Retrieve and update existing orders

Look up airports, airlines, and aircraft reference data

GET STARTED

Start building with Duffel API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Duffel API for, with concrete tasks.

★ AI Agent Flight Search

An AI agent can search flight availability by creating an offer request and reading the offers that come back. Through Jentic the agent finds the search operation by intent and supplies origin, destination, and dates, so a travel assistant can present flight options to a user without a developer wiring the endpoints by hand.

Create an offer request for a route and date, then return the cheapest offers with their prices

Automated Flight Booking

A travel workflow agent can complete a booking by placing an order for a chosen offer and then reading the order back to confirm it. The API creates and retrieves orders, so an agent can book a selected flight for a passenger and report the confirmation, with human approval gated by scoping rules.

Place an order for a selected offer with passenger details and return the order confirmation

Travel Reference Lookup

An agent can resolve travel reference data such as airports, airlines, aircraft, and seat maps to enrich its answers. The API exposes these lookups, so an assistant can translate a city into an airport code or show a seat map for a chosen offer alongside the booking flow.

Look up the airports for a city and return their codes and names

Key Endpoints

17 endpoints — the duffel api searches for flights and books them on behalf of travelers.

METHOD

PATH

DESCRIPTION

POST

/air/offer_requests

Create an offer request to search flights

GET

/air/offers

List offers for a request

GET

/air/offers/{id}

Get a single offer

POST

/air/orders

Place an order to book an offer

GET

/air/orders

List orders

GET

/air/orders/{id}

Get an order by id

GET

/air/airports

List airports

GET

/air/airlines

List airlines

POST

/air/offer_requests

Create an offer request to search flights

GET

/air/offers

List offers for a request

GET

/air/offers/{id}

Get a single offer

POST

/air/orders

Place an order to book an offer

GET

/air/orders

List orders

GET

/air/orders/{id}

Get an order by id

GET

/air/airports

List airports

GET

/air/airlines

List airlines

Why Jentic?

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

Setup

Wiring Duffel by hand means managing an access token, sending it as a bearer token on every request, and mapping the search-and-book operations. Through Jentic you install once, import Duffel from the API Directory, store the token once, and your agent calls it.

Permission scoping

You decide which Duffel operations the agent may use. Allow it to search offers while blocking order creation, and because order and offer ids sit in the URL path, a rule can restrict it to specific bookings so it cannot place or change orders you did not approve.

Credential isolation

Your Duffel access token is stored encrypted by your own Jentic One instance and injected as a bearer token at execution time. It never enters the agent's prompt, logs, or context window.

Intent-based discovery

Agents search Jentic by intent such as 'search flight offers' or 'create a flight order', and Jentic returns the matching Duffel operation with its input schema so the agent calls the right endpoint.

FAQs

Specific to using Duffel API through Jentic.

Is there a Duffel MCP server?

You don't need an MCP server to give your agent the Duffel API. Jentic connects it directly from the API Directory: import it, store your token once, and your agent can search offers and book flights. Operations are discovered on demand, so no extra tool definitions sit in the agent's context.

Can I restrict what my agent is allowed to do with the Duffel API?

Yes. You choose which operations the agent may call, so you can allow it to search offers but not place orders, keeping booking under human control. Because order and offer ids appear in the URL path, a rule can also pin the agent to specific orders, and every call is logged.

What authentication does the Duffel API use?

The Duffel API authenticates with a bearer token, sent in the Authorization header per its OpenAPI spec. Through Jentic the token is stored encrypted by your own Jentic One instance and added to each request at call time, so it never appears in the agent's prompt or logs.

Can my agent book a flight with the Duffel API?

Yes. After searching offers, the agent can place an order for a selected offer with passenger details and then retrieve the order to confirm it. You can keep booking gated behind a scoping rule so the agent only searches until a person approves the order.

What are the rate limits for the Duffel API?

The OpenAPI spec does not specify rate limits. Check the Duffel documentation at https://duffel.com/docs for the current request limits and offer expiry rules before running high-volume searches.

How do I search for flights through Jentic?

Search Jentic for 'search flight offers with Duffel', import the operation, and store your access token once. Your agent then creates offer requests and reads offers on demand. To run it on your own infrastructure, install Jentic One from its GitHub repo.

Duffel API

Name: Duffel API
Brand: Duffel
Availability: InStock

Official vendor OpenAPI document · agent-readyE CommerceOrder Managementbearer17 EndpointsREST

For Agents

Search for flights by creating offer requests, read and compare offers, book and manage orders, and look up airport, airline, aircraft, and seat-map reference data through the Duffel API.

Use for: Search for flights between two cities on a date, Compare the offers returned for a flight search, Book a specific flight offer for a passenger, Look up an existing order by its id

Not supported: Covers flight search and booking plus related reference data. Does not handle hotels, car rental, or payment processing outside the flight order flow.

The Duffel API searches for flights and books them on behalf of travelers. You can create an offer request to search availability, read the returned offers, place and manage orders, and look up reference data such as airports, airlines, aircraft, and seat maps. It covers the flight search-and-book flow end to end.

Jentic One on Github View OpenAPI Document

Connect the Duffel API to your agent

Capabilities

Start building with Duffel API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Duffel API