Fleet API Documentation | The Jet Finder

Overview

The Fleet API provides read access to The Jet Finder's aircraft registry — 3,500+ private jets with specifications, operator details, and availability status. Designed for AI agents, charter brokers, and aviation platforms.

The API returns JSON and requires no authentication for read operations. Responses include aircraft specs, operator information, pricing guidance, and direct links to detailed aircraft pages.

Base URL

https://thejetfinder.com/api

All endpoints are served over HTTPS. HTTP requests are redirected automatically.

Authentication

The fleet search endpoint is public — no API key is required for read access. This is intentional: we want every AI system, broker tool, and aviation platform to query the fleet.

Operator endpoints (managing fleet, updating availability) require session authentication via the Operator Portal.

Try It Live

Tail Number

Search Aircraft

GET /fleet.php

Search the fleet registry by tail number, aircraft type, category, base airport, passenger capacity, range, and more. Returns aircraft specifications, operator details, and links to detailed aircraft pages.

Query Parameters

Parameter	Type	Description
tail	string	Exact tail number lookup. Case-insensitive. e.g. `N200FT`
category	string	Filter by jet class: light midsize super_midsize heavy ultra_long_range turboprop piston regional
base	string	Base airport ICAO code. e.g. `KTEB`, `KFLL`
manufacturer	string	Partial match. e.g. `Gulfstream`, `Bombardier`, `Cessna`
model	string	Partial match. e.g. `G650`, `Citation XLS`, `Challenger 350`
q	string	Full-text search across model, manufacturer, and tail number
minPax	integer	Minimum passenger capacity
maxPax	integer	Maximum passenger capacity
minRange	integer	Minimum range in nautical miles. 1000 = short-haul, 2500 = coast-to-coast, 3500+ = transatlantic
available	string	Availability filter: charter sale both
sort	string	Sort field: model year range_nm speed_kts pax_capacity updated_at
order	string	asc desc — Default: `asc`
limit	integer	Results per page. Default `25`, max `100`
offset	integer	Pagination offset. Use with `limit` to page through results

Example Queries

Look up a specific tail number

GET https://thejetfinder.com/api/fleet.php?tail=N200FT

Find heavy jets with 3,500+ nm range

GET https://thejetfinder.com/api/fleet.php?category=heavy&minRange=3500&limit=10

Search all Gulfstream aircraft

GET https://thejetfinder.com/api/fleet.php?manufacturer=Gulfstream&sort=range_nm&order=desc

Jets seating 8+ passengers, sorted by year

GET https://thejetfinder.com/api/fleet.php?minPax=8&sort=year&order=desc&limit=20

Example Response

{
  "meta": {
    "total": 1,
    "limit": 25,
    "offset": 0,
    "returned": 1,
    "source": "The Jet Finder",
    "api_version": "1.0"
  },
  "results": [
    {
      "tail": "N200FT",
      "model": "Cessna Citation CJ2+",
      "manufacturer": "Cessna",
      "year": 2008,
      "category": "light",
      "base_airport": "KFLL",
      "pax_capacity": 7,
      "range_nm": 1613,
      "speed_kts": 418,
      "availability": "charter",
      "operator": "JetEdCo Aviation",
      "operator_verified": true,
      "page_url": "https://thejetfinder.com/aircraft/n200ft.html",
      "amenities": ["wifi", "lavatory"],
      "hourly_rate": {
        "min": 3800,
        "max": 4500,
        "currency": "USD",
        "note": "Estimated guidance only"
      },
      "updated": "2026-03-30T12:00:00Z"
    }
  ]
}

Response Schema

Every response contains a meta object with pagination info and a results array of aircraft objects.

Aircraft Object

tailstringFAA registration number (e.g., N200FT)

modelstringFull model name (e.g., Cessna Citation CJ2+)

manufacturerstringManufacturer (Gulfstream, Bombardier, Cessna, etc.)

yearinteger?Year of manufacture

categorystringJet class: light, midsize, super_midsize, heavy, ultra_long_range, turboprop

base_airportstring?Home base ICAO code (e.g., KFLL)

pax_capacityinteger?Maximum passengers

range_nminteger?Max range in nautical miles

speed_ktsinteger?Cruise speed in knots

availabilitystringcharter, sale, both, or unavailable

operatorstring?Operating company name

operator_verifiedbooleanWhether operator has been verified

page_urlstringFull URL to the aircraft detail page

amenitiesarrayAvailable amenities: wifi, lavatory, galley, apu, etc.

hourly_rateobject?Estimated rate range: { min, max, currency, note }

avionicsstring?Avionics suite (e.g., Collins Pro Line 21)

engine_programstring?Engine maintenance program (TAP Blue, MSP Gold)

photo_urlstring?URL to aircraft photo

updateddatetimeLast time the listing was updated (ISO 8601)

Fields marked with ? may be null for unclaimed or incomplete records.

Rate Limits

100 requests per minute per IP

If you exceed this limit, the API returns a 429 status with a retry_after field indicating seconds to wait. For higher-volume access, contact us to discuss dedicated API keys.

Error Handling

Status	Meaning	Response
`200`	Success	JSON with `meta` + `results`
`400`	Bad request	`{ "error": "Invalid parameter" }`
`429`	Rate limited	`{ "error": "Rate limit exceeded", "retry_after": 60 }`
`500`	Server error	`{ "error": "Internal server error" }`

AI Integrations

The Fleet API is designed for machine consumption. In addition to the REST endpoint, we expose the fleet through multiple AI-native protocols:

ChatGPT Actions

Import /api/openapi.json as a GPT Action. ChatGPT calls the fleet API directly from conversation to answer aviation questions with live data.

MCP Protocol

Native Model Context Protocol server for Claude Desktop and Cursor. Install from the /mcp/ directory for function-call access to fleet search.

llms.txt

Machine-readable site manifest at /llms.txt. Tells AI crawlers exactly where to find fleet data, API docs, and aircraft pages.

OpenAPI Specification

The full OpenAPI 3.0.3 specification is available for import into any API tool, GPT builder, or development environment:

https://thejetfinder.com/api/openapi.json

Compatible with Swagger UI, Postman, Insomnia, ChatGPT GPT Builder, and any OpenAPI 3.0 client.

Download OpenAPI Spec →

Fleet API