Endpoints
Four APIs, one key
One key works across everything. Photos flow keyless; programmatic use needs a free key.
POST/v1/resolveFree · key for volume
Ultra Resolve
A photo in, a confident aircraft registration out — even when the tail isn’t readable. Returns ranked candidates, each with a confidence score and the verified record behind it. Add any context you have (a partial tail, the airport, the date) to sharpen the result.
| Parameter | Type | Description |
|---|
| image | file | Multipart upload of the aircraft photo. |
| image_url | string | Alternative to a file — a URL to the image. Best path for agents/GPTs. |
| consent | boolean | Required for uploads — grants a license to process the image. |
| context.registration_hint | string? | A partial or uncertain tail number, any format. |
| context.airport | string? | ICAO/IATA where the photo was taken. |
| context.photo_date | date? | When the photo was taken (ISO). |
| context.make / model | string? | Your best guess at the type. |
GET/v1/identityFree · key for volume
Identity
A registration, serial, or free-text type name → a verified aircraft record from the graph: normalized make/model, category, registry status, year, and our licensed photos with attribution. We return truth from the graph, not an LLM guess.
| Parameter | Type | Description |
|---|
| registration | string | e.g. N526JS — exact tail lookup. |
| serial | string | Airframe serial number. |
| free_text | string | Fuzzy type, e.g. “Grob 103 Twin II”. |
| country | string? | Narrow by registry country. |
POST/v1/valuationFree · attribution required
Valuation
An aircraft → a value estimate with a range, condition, and the lowest active market ask, drawn from the Tail comps graph. Free to use — you just display a “Powered by Tailestimate” attribution wherever the number appears.
| Parameter | Type | Description |
|---|
| registration | string | Preferred — values that specific airframe. |
| model | string | Fallback — a representative estimate for the model. |
| year | int? | Narrow the model estimate by year. |
GET/embed/aircraft/:registrationFree · preview
Embeds
Drop-in cards and widgets for an aircraft, listing, or gallery — iframe or JSON, “Powered by TailExchange.” Built for clubs, schools, and brokers to surface live data on their own sites. Preview the aircraft card below.
| Parameter | Type | Description |
|---|
| registration | path | The aircraft to render. |
| format | string? | iframe (default) or json. |