API reference

Base URL: https://<domain>/v1. Free, but every request needs an API key. Machine-readable spec: openapi.yaml.

Authentication

Send your key in the x-api-key header. Create and revoke keys in the dashboard. Keys are shown once and stored hashed.

curl -H "x-api-key: $AVGEEKDB_KEY" "https://<domain>/v1/airports?q=heathrow"

Local dev (mock mode) accepts avg_demo_0000000000000000000000000000.

Endpoints

• GET /v1/airports: filters ident, iata, icao, country, type, continent, iso_region, scheduled_service
• GET /v1/airlines: filters ident, iata, icao, country, country_code, active, major, hub. Each airline includes hubs: an array of hub airport ICAO codes, primary first (?hub=EGLL filters by hub).
• GET /v1/aircraft: filters ident, icao, iata, family, manufacturer, engine_type, aircraft_type, status, in_production, major, cargo, military, is_primary

Common params: q (free-text search), limit (1-100, default 25), offset.

Responses

{ "data": [...], "meta": { "total": 3, "limit": 25, "offset": 0, "next_offset": null, "data_version": "2026.10.23" } }

Every response carries x-data-version. Errors: 400 bad params, 401 missing/invalid key, 403 revoked key, 429 rate limited.

Rate limits

60 requests/minute per key. Headers: x-ratelimit-limit, x-ratelimit-remaining, x-ratelimit-reset, and retry-after on 429.