Cabin — Flight Search & Booking with USDC

Search real flights across 500+ airlines and book with USDC on Base.

API Base URL

https://api.cabin.team

Endpoints

Search Flights

When the user wants to find flights:

curl -X POST https://api.cabin.team/v1/search \
  -H "Content-Type: application/json" \
  -d '{
    "from": "HAN",
    "to": "ATH",
    "date": "2026-03-15",
    "return_date": "2026-03-22",
    "adults": 1,
    "class": "ECONOMY",
    "currency": "USD",
    "max_results": 5
  }'

Parameters:

• from (required): Origin IATA airport code
• to (required): Destination IATA airport code
• date (required): Departure date (YYYY-MM-DD)
• return_date (optional): Return date for round-trip
• adults (optional, default 1): Number of passengers
• class (optional): ECONOMY, PREMIUM_ECONOMY, BUSINESS, FIRST
• currency (optional, default USD): Currency for prices
• max_results (optional, default 10): Maximum results

Response includes:

• results[] — Array of flight offers with prices, airlines, times, stops
• image_url — URL to a rendered PNG comparison image of results
• search_id — ID to reference when booking

Presenting results to users:

• Show the rendered image (fetch from image_url) for visual comparison
• Use structured data for specific questions ("which is cheapest?", "any direct flights?")
• Always show price in both USD and USDC equivalent

Book a Flight

When the user wants to book:

curl -X POST https://api.cabin.team/v1/book \
  -H "Content-Type: application/json" \
  -d '{
    "offer_id": "offer_1",
    "search_id": "abc123",
    "passengers": [{
      "type": "adult",
      "given_name": "John",
      "family_name": "Doe",
      "email": "[email protected]",
      "born_on": "1990-01-15",
      "gender": "m"
    }]
  }'

Required passenger info:

• given_name, family_name
• email
• born_on (YYYY-MM-DD)
• gender (m/f)

Response includes:

• booking_id — Cabin booking reference (CBN-YYYY-XXXX)
• amount_usdc — Amount to pay in USDC
• payment.deposit_address — USDC deposit address on Base
• payment.checkout_url — Payment page URL to share with user

USDC Payment Flow

After booking, the user needs to pay in USDC on Base:

1. Show the user the amount_usdc and payment.checkout_url
2. User can either: a. Send USDC directly to payment.deposit_address on Base b. Visit checkout_url for a guided payment experience
3. After payment, booking is confirmed automatically

If the agent has wallet capabilities (e.g., evm-wallet skill):

# Check USDC balance on Base
node src/balance.js base --json

# Send USDC to deposit address
node src/send.js base USDC \x3Cdeposit_address> \x3Camount_usdc> --yes --json

Check Booking Status

curl https://api.cabin.team/v1/booking/CBN-2026-XXXX

Statuses: awaiting_payment → confirmed → checked_in

Get Confirmation Page

https://api.cabin.team/v1/booking/CBN-2026-XXXX/confirmation

Share this URL with the user after payment confirmation.

Get Check-in Page

https://api.cabin.team/v1/booking/CBN-2026-XXXX/checkin

Share when it's time to check in for the flight.

Common IATA Codes

Workflow Examples

Simple one-way search

User: "Find me a flight from Bangkok to Tokyo next Friday"

1. Parse: from=BKK, to=NRT (or HND), date=next Friday
2. Call POST /v1/search
3. Show image_url to user
4. Present top 3-5 options with prices

Round-trip booking

User: "Book the cheapest round-trip from London to Barcelona, March 15-22"

1. Search: from=LHR, to=BCN, date=2026-03-15, return_date=2026-03-22
2. Present options
3. User picks one → collect passenger details
4. POST /v1/book with passenger info
5. Share payment URL → user pays in USDC
6. Confirm booking → share confirmation page

Multi-passenger

User: "We need flights for 3 people, Seoul to Bali, April 1-10"

1. Search with adults=3
2. Prices shown are per-person
3. When booking, collect details for all 3 passengers
4. Total USDC amount = per-person × 3

Error Handling

• No results: Try nearby airports or different dates
• Booking expired: Search results expire after 30 minutes, search again
• Payment timeout: Bookings expire 1 hour after creation if unpaid
• Invalid airport code: Suggest the correct IATA code

USDC on Base

• Chain: Base (Ethereum L2)
• Token: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
• Gas fees: ~$0.01 per transaction
• Confirmation: ~2 seconds