Developers
Public aircraft data API.
Read aircraft summaries, model observations and source references. Responses include dataset versions, dates and explicit unknown or conflict states.
API overview
Public read surfaces
| Endpoint | Description |
|---|---|
GET /v1/health | Active release and schema verification |
GET /v1/lookup/{registration} | Dated current FAA registration summary; conflict and unresolved identity stay explicit |
GET /v1/airframes/{physical_airframe_id} | Current registration summary for a verified physical identity |
GET /v1/current-source-reports/{registration} | Canonical public source-fact report; identity conflict 409, unresolved 422, absent registration 404, unavailable source 503 |
GET /v1/sdr-source-models/{source_model_key} | Exact recorded-model source rows, not aircraft history or failure rates |
GET /v1/directive-catalog | FAA directive catalog source records |
GET /v1/ad-publication-catalog | Current whole-corpus AD publication text and source metadata |
GET /v1/ad-source-publications | Selected AD publication source editions |
GET /v1/models/{model_key}/intelligence | Retained model analysis only where the model and date window are covered |
GET /v1/ads/{id} | Structured AD projection |
GET /v1/evidence/{id} | Evidence metadata and artifact availability |
Response handling
Contract rules
- Pin every material response to dataset and schema revisions.
- Do not overload null when a semantic state matters.
- Do not degrade identity conflict into a reassuring HTTP 200 normal result.
- Do not perform raw data acquisition, PDF parsing, clustering, or model training at request time.
Current availability
Availability
This overview describes the public read routes and response contracts. Individual datasets and endpoints can change; the service status page reports lookup availability; each free aircraft report independently checks its source edition.
Free lookup and the full report are available without payment during launch when identity and sources can be verified.