> ## Documentation Index
> Fetch the complete documentation index at: https://docs.earthity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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#problem-anatomy).

## Errors

* [internal\_error](/errors#internal_error)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.