Worker JSON API (v1 Read-Only)

The Airline Fleet Intelligence API is deployed on Cloudflare Workers and backed by KV edge caching, providing sub-50ms JSON responses for airframe lookups, fleet compositions, and weekly movements. Documentation updated 2026-09-17.

API Overview & Authentication

Base Endpoint: https://api.example-airlines.com/v1

Authentication: None required for public v1 tier (Rate limited to 60 requests per minute per IP address).

Response Format: Standard UTF-8 JSON with Cache-Control: public, max-age=3600.

Available Endpoints

GET /v1/airlines/:slug

Retrieve profile, metadata, and observed active/idle fleet totals for an airline.

curl -s https://api.example-airlines.com/v1/airlines/air-canada
GET /v1/airlines/:slug/fleet

Retrieve the full list of observed airframes, tail registrations, and types for an airline.

curl -s https://api.example-airlines.com/v1/airlines/air-canada/fleet
GET /v1/airframes/:registration

Retrieve registry records, operator history, Mode S transponder hex, and last observed airport for an airframe.

curl -s https://api.example-airlines.com/v1/airframes/C-FGCX
GET /v1/airlines/:slug/weekly

Retrieve weekly historical active, idle, and stored counts for time series analysis.

curl -s https://api.example-airlines.com/v1/airlines/air-canada/weekly
GET /v1/movements/:week

Retrieve the structured movements digest events for a given ISO week (e.g. 2026-W37).

curl -s https://api.example-airlines.com/v1/movements/2026-W37