{"openapi":"3.1.0","info":{"title":"Agent Flights","version":"1.2.0","summary":"Cheapest flights worldwide, strong on Africa","description":"Search live and cached flight prices, always ranked by total (all-in) price. Kiwi.com is on by default. Duffel and Travelpayouts light up when their env vars are set. v1 expands metro/alternate airports and stitches self-transfer one-ways through hubs when that beats the through fare."},"servers":[{"url":"https://lowest.flights","description":"Agent Flights"}],"security":[{},{"bearerAuth":[]},{"apiKeyHeader":[]}],"paths":{"/api/v1/health":{"get":{"summary":"Service and source status","operationId":"getHealth","responses":{"200":{"description":"Health payload"}}}},"/api/v1/search":{"get":{"summary":"Search cheapest flights","operationId":"searchCheapestGet","parameters":[{"name":"origin","in":"query","required":true,"schema":{"type":"string"}},{"name":"destination","in":"query","required":true,"schema":{"type":"string"}},{"name":"departureDate","in":"query","required":true,"schema":{"type":"string","format":"date"}},{"name":"returnDate","in":"query","required":false,"schema":{"type":"string","format":"date"}},{"name":"flexDays","in":"query","schema":{"type":"integer","minimum":0,"maximum":10}},{"name":"adults","in":"query","schema":{"type":"integer","default":1}},{"name":"children","in":"query","schema":{"type":"integer","default":0}},{"name":"infants","in":"query","schema":{"type":"integer","default":0}},{"name":"currency","in":"query","schema":{"type":"string","default":"EUR"}},{"name":"cabinClass","in":"query","schema":{"type":"string","enum":["economy","premium_economy","business","first"]}},{"name":"checkedBagsPerAdult","in":"query","schema":{"type":"integer","minimum":0,"maximum":2}},{"name":"allowSelfTransfer","in":"query","schema":{"type":"boolean","default":true}},{"name":"nearbyAirports","in":"query","schema":{"type":"boolean","default":true}},{"name":"stitchSelfTransfer","in":"query","schema":{"type":"boolean","default":true}},{"name":"maxStops","in":"query","schema":{"type":"integer"}},{"name":"limit","in":"query","schema":{"type":"integer","default":20}}],"responses":{"200":{"description":"Ranked search"}}},"post":{"summary":"Search cheapest flights","operationId":"searchCheapestPost","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchRequest"}}}},"responses":{"200":{"description":"Ranked search"}}}},"/api/v1/explore":{"get":{"summary":"Cheapest destinations from an origin","operationId":"exploreAnywhere","parameters":[{"name":"origin","in":"query","required":true,"schema":{"type":"string"}},{"name":"month","in":"query","schema":{"type":"string","example":"2026-12"}},{"name":"budget","in":"query","schema":{"type":"number"}},{"name":"currency","in":"query","schema":{"type":"string","default":"EUR"}}],"responses":{"200":{"description":"Destination list"}}}},"/api/v1/calendar":{"get":{"summary":"Cheapest price per day in a month","operationId":"priceCalendar","parameters":[{"name":"origin","in":"query","required":true,"schema":{"type":"string"}},{"name":"destination","in":"query","required":true,"schema":{"type":"string"}},{"name":"month","in":"query","required":true,"schema":{"type":"string","example":"2026-12"}},{"name":"currency","in":"query","schema":{"type":"string","default":"EUR"}}],"responses":{"200":{"description":"Price calendar"}}}},"/api/v1/offers/{id}":{"get":{"summary":"Fetch a previously returned offer","operationId":"getOffer","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Offer"},"404":{"description":"Unknown or expired offer"}}}},"/api/v1/offers/{id}/booking":{"get":{"summary":"Booking link for an offer","operationId":"bookingLink","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Booking payload"}}}},"/api/v1/fx":{"get":{"summary":"FX rates for display currencies","operationId":"getFx","responses":{"200":{"description":"Rates vs EUR plus optional conversion"}}}},"/api/v1/mcp/unlock":{"post":{"summary":"MCP access. Returns { free: true } while MCP is free; otherwise starts the one-time unlock checkout.","operationId":"unlockMcp","responses":{"200":{"description":"Checkout session"}}}},"/api/v1/checkout":{"post":{"summary":"Legacy Duffel ticket checkout (off unless AIRBOT_LEGACY_COMMERCE)","operationId":"createCheckout","responses":{"200":{"description":"Checkout session"}}}},"/api/v1/orders/{id}":{"get":{"summary":"Order status after payment. Pass ?t=<accessToken> (from the unlock response) to see the issued MCP key.","operationId":"getOrder","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"t","in":"query","required":false,"schema":{"type":"string"}}],"responses":{"200":{"description":"Order"}}}},"/api/v1/keys":{"post":{"summary":"Mint a preview REST key (not full MCP)","operationId":"createApiKey","responses":{"200":{"description":"Key (shown once)"}}}},"/api/v1/agents/register":{"post":{"summary":"Register an agent and get an API key in one call (no signup form)","description":"Guests can call every endpoint keyless with tight rate limits. Register once to get an af_live_ key with higher limits and attribution: every bookingLink you return then credits your agentId. The key is shown once; send it as Authorization: Bearer <key> or x-api-key.","operationId":"registerAgent","security":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRegisterRequest"}}}},"responses":{"201":{"description":"Agent registered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AgentRegisterResponse"}}}},"400":{"description":"Invalid body"},"429":{"description":"Too many registrations from this IP today"}}}},"/go/{offerId}":{"get":{"summary":"Attributed booking redirect (use the bookingLink from search results as-is)","description":"Every search result carries bookingLink = /go/{offerId}?a={agentId}&src={client}. Opening it records a booking_click credited to the agent and client, then 302-redirects to the best-paying partner for that itinerary. Hand this URL to the traveller unchanged; do not rewrite it to a partner URL.","operationId":"bookingRedirect","security":[],"parameters":[{"name":"offerId","in":"path","required":true,"schema":{"type":"string"}},{"name":"a","in":"query","description":"Agent id for attribution","schema":{"type":"string"}},{"name":"src","in":"query","description":"Calling client (claude, chatgpt, cursor, web…)","schema":{"type":"string"}},{"name":"from","in":"query","schema":{"type":"string","example":"ABJ"}},{"name":"to","in":"query","schema":{"type":"string","example":"CDG"}},{"name":"depart","in":"query","schema":{"type":"string","format":"date"}},{"name":"return","in":"query","schema":{"type":"string","format":"date"}},{"name":"currency","in":"query","schema":{"type":"string","default":"EUR"}}],"responses":{"200":{"description":"Interstitial page for browsers when the partner needs it"},"302":{"description":"Redirect to the booking partner"},"404":{"description":"Unknown or expired offer"}}}},"/api/v1/billing/subscribe":{"post":{"summary":"MCP unlock checkout (product=mcp). Legacy plans only if AIRBOT_LEGACY_COMMERCE","operationId":"subscribe","responses":{"200":{"description":"Checkout"}}}},"/api/v1/alerts":{"post":{"summary":"Create a price alert (legacy, off by default)","operationId":"createAlert","responses":{"200":{"description":"Alert"}}}},"/api/v1/webhooks/lomi":{"post":{"summary":"lomi. webhook (HMAC-SHA256 on raw body)","operationId":"lomiWebhook","responses":{"200":{"description":"Ack"}}}},"/api/v1/admin/summary":{"get":{"summary":"Clicks, orders, revenue, API usage","operationId":"adminSummary","responses":{"200":{"description":"Ledger snapshot"}}}},"/api/v1/pricing":{"get":{"summary":"MCP unlock prices and redirect-commission notes","operationId":"pricing","responses":{"200":{"description":"Catalog"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"af_live_ key from /api/v1/agents/register"},"apiKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key"}},"schemas":{"AgentRegisterRequest":{"type":"object","properties":{"name":{"type":"string","example":"Trip planner agent"},"client":{"type":"string","example":"claude","description":"Your client / platform; used as the default src"},"website":{"type":"string","format":"uri"},"contact":{"type":"string","description":"Email or URL for payout / abuse contact"}}},"AgentRegisterResponse":{"type":"object","properties":{"agentId":{"type":"string"},"apiKey":{"type":"string","description":"Shown once"},"keyPrefix":{"type":"string"},"plan":{"type":"string"},"usage":{"type":"object"}}},"SearchRequest":{"type":"object","required":["origin","destination","departureDate"],"properties":{"origin":{"type":"string","example":"ABJ"},"destination":{"type":"string","example":"CDG"},"departureDate":{"type":"string","format":"date","example":"2026-12-15"},"returnDate":{"type":"string","format":"date"},"flexDays":{"type":"integer","minimum":0,"maximum":10},"adults":{"type":"integer","default":1},"children":{"type":"integer","default":0},"infants":{"type":"integer","default":0},"currency":{"type":"string","default":"EUR"},"cabinClass":{"type":"string","enum":["economy","premium_economy","business","first"]},"checkedBagsPerAdult":{"type":"integer","minimum":0,"maximum":2},"allowSelfTransfer":{"type":"boolean","default":true},"nearbyAirports":{"type":"boolean","default":true},"stitchSelfTransfer":{"type":"boolean","default":true},"maxStops":{"type":"integer"},"limit":{"type":"integer","default":20}}}}}}