Developers

API Reference

Name: FlyorBook
Brand: FlyorBook
Availability: InStock

Integrate FlyorBook's flight search, booking, price intelligence, and flight risk scores into your applications.

v1 StableREST + WebSocketJSON responses

Base URL

https://api.flyorbook.com/api/v1

Authentication

All API requests require authentication. Include your API key in the Authorization header. API keys are managed in your Account Settings.

Authorization: Bearer YOUR_API_KEY

Rate Limits

Free100 requests/hour, 15/minute

Pro1,000 requests/hour, unlimited/minute

Rate limit headers returned with every response:

X-RateLimit-Limit: 1000X-RateLimit-Remaining: 994X-RateLimit-Reset: 1710000000

Core Endpoints

GET/flights/search

Search for available flights with provider-backed pricing when available.

Parameters:

origin (string, required) — IATA airport codedestination (string, required) — IATA airport codedeparture_date (YYYY-MM-DD, required)return_date (YYYY-MM-DD, optional)cabin_class (enum, optional) — economy, premium_economy, business, firstpassengers (int, optional, default: 1)

Example response:

{ "flights": [{ "id": 1234, "flight_number": "AA100", "origin": { "code": "JFK", "city": "New York" }, "destination": { "code": "LAX", "city": "Los Angeles" }, "departure_time": "2026-03-15T08:00:00Z", "arrival_time": "2026-03-15T11:30:00Z", "airline": "American Airlines", "prices": [{ "cabin_class": "economy", "current_price": 299.00, "currency": "USD" }], "risk": { "risk_level": "LOW", "delay_probability": 0.12 } }], "total": 42 }

GET/flights/{flight_id}/price-history

Historical price data and ML predictions for a specific flight.

Example response:

{ "flight_id": 1234, "prices": [ { "timestamp": "2026-03-08T12:00:00Z", "price": 315.00 }, { "timestamp": "2026-03-09T12:00:00Z", "price": 299.00 } ], "trend": "falling", "prediction": { "direction": "down", "confidence": 0.78, "predicted_price": 285.00 } }

GET/intelligence/flight-risk/{flight_id}

Flight risk score with delay probability and safer alternatives.

Example response:

{ "flight_id": 1234, "risk_level": "LOW", "delay_probability": 0.12, "factors": ["weather_clear", "airline_on_time_92pct"], "alternatives": [] }

POST/bids

Create a target-price bid with optional auto-book.

Request body:

{ "flight_id": 1234, "target_price": 250.00, "auto_book": true, "expires_in_hours": 24 }

Response:

{ "id": 567, "status": "active", "flight_id": 1234, "target_price": 250.00, "current_price": 299.00, "auto_book": true, "expires_at": "2026-03-10T14:00:00Z" }

GET/bids

List your bids. Filter by status: active, triggered, expired, cancelled.

GET/alerts/price-predictions/{flight_id}

ML-powered price predictions and optimal booking window.

Response:

{ "flight_id": 1234, "current_price": 299.00, "prediction": { "direction": "down", "confidence": 0.78, "predicted_low": 275.00, "best_booking_window": "2-3 days" } }

WebSocket API

Connect to our WebSocket endpoint for price updates and bid notifications. Heartbeat sent every 30 seconds.

Endpoint:

wss://api.flyorbook.com/api/v1/ws/prices

Authenticate:

{ "action": "authenticate", "token": "YOUR_JWT" }

Subscribe to flights:

{ "action": "subscribe", "flight_ids": [1234, 5678] }

Price update event:

{ "type": "price_update", "flight_id": 1234, "price": 289.00, "trend": "falling", "timestamp": "2026-03-09T14:30:00Z" }

Bid triggered event:

{ "type": "bid_triggered", "bid_id": 567, "flight_id": 1234, "triggered_price": 249.00 }

Error Codes

Status

Code

Description

400

BAD_REQUEST

Invalid parameters or malformed request

401

UNAUTHORIZED

Missing or invalid API key

403

FORBIDDEN

Insufficient plan tier for this endpoint

404

NOT_FOUND

Resource not found

409

CONFLICT

Duplicate booking or bid conflict

422

VALIDATION_ERROR

Request body validation failed

429

RATE_LIMIT_EXCEEDED

Too many requests — retry after cooldown

500

INTERNAL_ERROR

Server error — contact support if persistent

Error response format:

{ "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Rate limit exceeded. Retry after 60 seconds.", "details": { "retry_after": 60 } } }

Pagination

List endpoints use cursor-based pagination. Pass limit (default 20, max 100) and cursor (opaque string from previous response).

{ "data": [...], "pagination": { "next_cursor": "eyJpZCI6MTIzNH0", "has_more": true } }

API Access

Access the FlyorBook API directly via REST. Pro subscribers get API access with higher rate limits.

REST API

Base URL: https://api.flyorbook.com/api/v1

Public OpenAPI Schema

Download the machine-readable schema for unauthenticated search and discovery operations. Account, booking, payment, webhook and administrative operations are intentionally excluded.

OpenAPI JSON

Get API Access

API access is included with all FlyorBook accounts. Rate limits depend on your plan tier.

View Pricing Plans|Enterprise API Access

Pricing Contact Terms

Core Endpoints

GET/flights/search

Search for available flights with provider-backed pricing when available.

Parameters:

Example response:

GET/flights/{flight_id}/price-history

Historical price data and ML predictions for a specific flight.

Example response:

GET/intelligence/flight-risk/{flight_id}

Flight risk score with delay probability and safer alternatives.

Example response:

{ "flight_id": 1234, "risk_level": "LOW", "delay_probability": 0.12, "factors": ["weather_clear", "airline_on_time_92pct"], "alternatives": [] }

POST/bids

Create a target-price bid with optional auto-book.

Request body:

{ "flight_id": 1234, "target_price": 250.00, "auto_book": true, "expires_in_hours": 24 }

Response:

{ "id": 567, "status": "active", "flight_id": 1234, "target_price": 250.00, "current_price": 299.00, "auto_book": true, "expires_at": "2026-03-10T14:00:00Z" }

GET/bids

List your bids. Filter by status: active, triggered, expired, cancelled.

GET/alerts/price-predictions/{flight_id}

ML-powered price predictions and optimal booking window.

Response:

{ "flight_id": 1234, "current_price": 299.00, "prediction": { "direction": "down", "confidence": 0.78, "predicted_low": 275.00, "best_booking_window": "2-3 days" } }

WebSocket API

Connect to our WebSocket endpoint for price updates and bid notifications. Heartbeat sent every 30 seconds.

Endpoint:

wss://api.flyorbook.com/api/v1/ws/prices

Authenticate:

{ "action": "authenticate", "token": "YOUR_JWT" }

Subscribe to flights:

{ "action": "subscribe", "flight_ids": [1234, 5678] }

Price update event:

{ "type": "price_update", "flight_id": 1234, "price": 289.00, "trend": "falling", "timestamp": "2026-03-09T14:30:00Z" }

Bid triggered event:

{ "type": "bid_triggered", "bid_id": 567, "flight_id": 1234, "triggered_price": 249.00 }

Error Codes

Status

Code

Description

400

BAD_REQUEST

Invalid parameters or malformed request

401

UNAUTHORIZED

Missing or invalid API key

403

FORBIDDEN

Insufficient plan tier for this endpoint

404

NOT_FOUND

Resource not found

409

CONFLICT

Duplicate booking or bid conflict

422

VALIDATION_ERROR

Request body validation failed

429

RATE_LIMIT_EXCEEDED

Too many requests — retry after cooldown

500

INTERNAL_ERROR

Server error — contact support if persistent

Error response format:

{ "error": { "code": "RATE_LIMIT_EXCEEDED", "message": "Rate limit exceeded. Retry after 60 seconds.", "details": { "retry_after": 60 } } }