Docs / REST API Reference

REST API Reference

HTTP endpoints for log ingestion, SQL metadata filtering, and downsampled series retrieval.


All endpoints accept an optional X-API-Key header matching ORG_API_KEY.

POST /api/v1/flights/upload

Multipart form upload that stores the raw log, generates a normalized .parquet file, enriches historical takeoff weather via Open-Meteo, and indexes summary metrics in PostgreSQL.

Form Fields:


GET /api/v1/flights

Returns filtered flight summary rows ordered by takeoff_time DESC.

Query Parameters:


GET /api/v1/flights/{flight_id}/series

Returns downsampled JSON arrays (t_sec, vbat_v, climb_rate_mps, throttle_pct) from the flight’s Parquet file for fast web plotting.