duffel

Search live airline inventory and return bookable flight offers with pricing and baggage details.

616|59|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/borski/travel-hacking-toolkit --skill duffel
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: duffel
Source: https://github.com/borski/travel-hacking-toolkit/tree/main/skills/duffel
Command: npx skills add https://github.com/borski/travel-hacking-toolkit --skill duffel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides live access to global airline inventory and converts it into bookable offers with accurate per-fare-class pricing, baggage allowances, and expiry information so users can quickly compare cash fares and obtain valid booking links.

Core Features & Use Cases

  • Real-time GDS pricing: Returns bookable offers with total, base, and tax breakdowns, owner carrier, and expiry timestamps.
  • Flexible itinerary search: Supports one-way, round-trip, and multi-city searches with cabin selection, nonstop-only filtering, time preferences, and multiple passenger types.
  • Use Case: Compare cash fares and cabin options for a business-class itinerary, surface the five cheapest bookable offers, and provide segment-level details and booking links for immediate purchase.

Quick Start

Search Duffel for the five cheapest round-trip business class offers from SFO to NRT departing 2026-08-15 and return the prices, segments, and booking links.

Frequently Asked Questions about duffel

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search live airline inventory for bookable flight offers?

To search live airline inventory for bookable flight offers, query real-time GDS pricing data to retrieve total amounts, tax breakdowns, and expiry timestamps. This process returns valid segment details and booking links for immediate purchase across one-way, round-trip, and multi-city itineraries.

Can I filter multi-city flight searches by cabin class and nonstop options?

Yes, multi-city flight searches support cabin class selection and nonstop-only filtering. You can apply time preferences and query multiple passenger types simultaneously, returning accurate per-fare-class pricing and baggage allowances for complex itineraries.

Do I need a Duffel API token to access real-time GDS flight pricing?

Yes, you need a Duffel v2 API token with air.offer_requests.create permission. You must include the Duffel-Version header in your requests and honor the supplier_timeout parameter to successfully retrieve live flight pricing and bookable offers.

What flight pricing details are included in bookable offer responses?

Bookable offer responses include total_amount, base, and tax breakdowns, along with owner carrier information and expiry timestamps. You also extract slices, segments, and offers.id to display per-fare-class pricing, baggage details, and booking links.

How do I handle supplier_timeout when querying live flight inventory?

When querying live flight inventory, you must honor the supplier_timeout parameter to manage response delays from airline suppliers. This ensures your search returns available bookable offers within the expected timeframe without hanging indefinitely.