Public API
Use the public read-only schema for flight, stay, and route discovery. FlyOrBook does not issue public API keys, webhooks, or external SDKs; bookings and payments happen exclusively in the web application.
Public search and discovery endpoints do not require sign-in. Protected account endpoints accept only the first-party web session cookie or short-lived JWT issued after interactive sign-in (including MFA when enabled). FlyOrBook does not issue API keys in Account Settings, and does not offer public webhooks or external SDKs.
FlyOrBook does not issue API keys in Account Settings, and does not provide public webhook subscriptions or external developer SDKs.
Keep session tokens private and out of URLs. Cookie-authenticated web mutations require CSRF protection: request GET /auth/csrf with the same cookie jar, then send its csrf_token in the X-CSRF-Token header. Never send a payment processor or provider secret key to a FlyOrBook endpoint.
Plan quotas, endpoint limits and supplier usage controls all apply. Pro increases selected limits; it does not remove endpoint or supplier restrictions. Read the current plan limits from /subscriptions/tiers. Make searches for real traveller requests and avoid automated polling.
When a request returns HTTP 429, respect Retry-After before trying again. Read X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset when supplied. Do not automatically retry a purchase after a timeout or an uncertain response.
These are unauthenticated GET operations. Use the linked OpenAPI schema for the exact parameters, required fields, response models and pagination of each operation. Pagination is endpoint-specific; there is no universal cursor contract.
GET /flights/searchSearch live flight offers for a traveller-requested route and date.
GET /flights/airports/searchSearch airports by name, city or code.
GET /flights/airlines/listList airlines known to the search providers.
GET /flights/providersRead flight provider availability.
GET /flights/dealsRead current flight deals.
GET /flights/calendarRead calendar fare availability for a route.
GET /flights/status/{flight_number}Read the status of a flight by flight number.
GET /flights/tracking/{flight_number}Read tracking information for a flight by flight number. Show the returned attributions (adsb.lol, ODbL) with positions.
GET /stays/searchSearch live accommodation offers for the requested stay. Show any returned attributions (OpenStreetMap geocoding).
GET /stays/accommodations/{accommodation_id}Read accommodation details.
GET /experiences/searchDiscover experiences from OpenStreetMap; show the returned attribution. Booking is unavailable.
GET /experiences/products/{product_id}Read one OpenStreetMap place; show the returned attribution.
GET /discover/airlinesDiscover airlines.
GET /discover/airportsDiscover airports.
GET /discover/knowledgeRead destination knowledge entries.
GET /discover/routesDiscover routes.
GET /discover/statusRead discovery service status.
GET /subscriptions/tiersRead the available subscription plans and current limits.
GET /subscriptions/tiers/configRead subscription tier configuration.
GET /subscriptions/tiers/{tier_name}Read one subscription plan and its current limits.
Capability-gated endpoints: Destination weather forecasts (/stays/weather) are omitted from the active public OpenAPI schema while disabled; querying the endpoint while disabled returns HTTP 200 with {"available": false, "code": "stay_weather_unavailable"}.
Public search endpoints return live travel offers, not confirmed reservations. Prices and availability can change before checkout revalidation. Checkout, payment authorisation, supplier confirmation, ticket issuance, and refund settlement are handled exclusively through secure checkout in the web application.
Price targets and price alerts do not authorize a purchase. Automatic purchasing is unavailable. Use the web application to review traveller details, current pricing and cancellation terms, then complete payment through secure checkout. Experiences are discovery only.
Signed-in web application sessions subscribe to live price updates and price-target notifications over WebSocket. Connect first, authenticate in a message, then subscribe after the server confirms authentication. Never put tokens in the connection URL. A price or target event is not a booking or ticket confirmation.
HTTP 401 requires a valid session; HTTP 403 can indicate permissions, eligibility or CSRF checks. HTTP 409 can indicate a conflicting or already-pending operation. HTTP 422 identifies invalid input, and HTTP 429 signals a usage limit. Inspect the response error details. After an uncertain payment or booking response, check the existing operation before submitting again; an error does not prove that a purchase failed.
Download the machine-readable schema for unauthenticated search and discovery operations. Account, booking, payment, webhook and administrative operations are intentionally excluded.
OpenAPI JSON