API Reference

List the airframe catalog

Lists every selectable airframe in the Outpost catalog, A-Z by model name (the words on the card, with the brand on its own line) - the same entries, in the same order, as the operator funnel’s drone picker - projected to a published allowlist: manufacturer, model, charge connector and product shot. Public, unauthenticated reference data for the marketing site’s drone catalog page: CDN-cached (s-maxage=300 with a day of stale-while-revalidate) and readable cross-origin (Access-Control-Allow-Origin: *; no credentials and no custom headers, so a browser fetch() is never preflighted). An edit in the catalog admin reaches this response within about 10 minutes; compare version to tell whether it has. Served by production only.

`GET /api/catalog/airframes`

Production: GET https://outpost.earthity.com/api/catalog/airframes
Gate: public
Read-only: true
Destructive: false
Idempotent: true

Responses

`200` - The catalog.

Header	Description
`Access-Control-Allow-Origin`	`*` - public, non-credentialed reference data.
`Cache-Control`	`public, max-age=60, s-maxage=300, stale-while-revalidate=86400` from the origin; Vercel’s edge may present it to clients as `public`.

Property	Type	Required	Constraints	Description
`version`	`string`	yes	-	Opaque - compare for equality only. Changes whenever a published field of any entry changes.
`airframes`	`array<object>`	yes	-

`airframes[]`

Property	Type	Required	Constraints	Description
`id`	`string`	yes	-	Stable slug, e.g. `dji-m350`.
`name`	`string`	yes	-	The full name as the catalog stores it, carrying the brand only when the catalog does: `Matrice 350 RTK` for `dji-m350`, `Zipline P2` for Zipline. `model` is the brand-stripped form, and `manufacturer` always names the maker.
`manufacturer`	`string`	yes	-
`model`	`string`	yes	-	`name` without the manufacturer’s brand, e.g. `Matrice 350 RTK`. Equal to `name` when stripping the brand would leave no model name (`Teal 2`).
`connector`	`object`	yes	-	How the airframe’s battery charges.
`image`	`object or null`	yes	-	Product shot. Null until one is uploaded.

`connector`

Property	Type	Required	Constraints	Description
`id`	`string`	yes	enum: usb_c_pd, micro_usb, xt90, as150u, lihv_4s, px4_smart, smart_liion_paired, direct_contact_smart_battery, dji_tb_4s, dji_tb_6s, dji_tb51_paired, dji_bs65_tb65, dji_bs100_tb100, dji_dock1_pad, dji_dock2_pad, autel_abx, autel_alpha_6s, skydio_x10_pad, proprietary_charger, proprietary_closed
`label`	`string`	yes	-	Reader-facing name, e.g. `DJI BS65 / TB65`.

`image`

Property	Type	Required	Constraints	Description
`url`	`string`	yes	format: uri	Public Supabase Storage URL.
`fit`	`object`	yes	-	How the shot sits on the catalog card, as CSS lengths ready to assign: its width, and its centre’s offset from the card’s centre.

`fit`

Property	Type	Required	Constraints	Description
`w`	`string`	yes	-	Width as a percentage of the card’s width, e.g. `112.00%`.
`x`	`string`	yes	-	Horizontal offset, percent of the card’s width; positive is right.
`y`	`string`	yes	-	Vertical offset, percent of the card’s height; positive is down.

`500` - The catalog could not be loaded. Never cached (`Cache-Control: no-store`), and still readable cross-origin.

Body: application/problem+json - see Problem anatomy.

Errors

internal_error