API Endpoints

Complete reference for all available API endpoints.

Flight Search

POST /v1/flights/search

Search for available flights based on route, date, and preferences.

Request Body

{
  "legs": [
    {
      "origin": { "icao": "KJFK" },
      "destination": { "icao": "KLAX" },
      "departure": "2024-06-15T10:00:00Z",
      "passengers": 4
    }
  ],
  "category": "midsize_jet",
  "includePhotos": true,
  "checkAvailability": true
}

Parameters

Field	Type	Required	Description
legs	array	Yes	Flight legs with origin, destination, and departure
category	string	No	Aircraft category filter
includePhotos	boolean	No	Include aircraft photos
checkAvailability	boolean	No	Check real-time availability

POST /v1/flights/availability

Check aircraft availability for a specific route and date.

POST /v1/flights/pricing

Get detailed pricing for a flight including taxes and fees.

Bookings

POST /v1/bookings

Create a new booking.

Request Body

{
  "trip_type": "one-way",
  "legs": [
    {
      "origin": { "icao": "KJFK", "name": "JFK Airport" },
      "destination": { "icao": "KLAX", "name": "LAX Airport" },
      "departure": "2024-06-15T10:00:00Z",
      "passengers": 4
    }
  ],
  "passengers": 4,
  "aircraft": { "category": "midsize_jet" },
  "contact": {
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+1-555-0123"
  },
  "special_requests": "Vegetarian meals"
}

GET /v1/bookings

List all bookings for your API key.

Query Parameters

Parameter	Type	Description
page	integer	Page number (default: 1)
limit	integer	Items per page (default: 20)
status	string	Filter by status

GET /v1/bookings/:id

Get a specific booking by ID.

PUT /v1/bookings/:id

Update an existing booking.

DELETE /v1/bookings/:id

Cancel a booking.

POST /v1/bookings/:id/confirm

Confirm a pending booking.

GET /v1/bookings/:id/status

Get the current status of a booking.

Reference Data

GET /v1/airports

List all supported airports.

GET /v1/airports/:code

Get airport details by ICAO or IATA code.

GET /v1/airlines

List all operators/airlines.

GET /v1/airlines/:code

Get operator details by code.

Account

GET /v1/account

Get your account information and API key details.

Response

{
  "success": true,
  "data": {
    "client_id": "uuid",
    "client_name": "Your Company",
    "api_key_name": "Production Key",
    "permissions": {
      "flights_search": true,
      "flights_book": true,
      "flights_manage": false
    },
    "rate_limits": {
      "per_minute": 60,
      "per_hour": 1000,
      "per_day": 10000
    }
  }
}

GET /v1/account/usage

Get your API usage statistics.

Aircraft Categories

The following aircraft categories are supported:

Category	Description	Typical Capacity
`very_light_jet`	Entry-level jets	4-5 passengers
`light_jet`	Light jets	6-8 passengers
`midsize_jet`	Midsize jets	7-9 passengers
`super_midsize_jet`	Super midsize jets	8-10 passengers
`heavy_jet`	Heavy/large cabin jets	10-16 passengers
`ultra_long_range_jet`	Ultra long range jets	12-19 passengers