> ## 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 dock catalog

> Returns dock hardware catalog rows (OEM dock models, not user-owned Dock resources), optionally narrowed by manufacturer or by compatibility with a given airframe id. Use this to populate a dock-model picker or compatibility lookup; it is reference data only and never reflects any tenant's actual deployed docks. Public, unauthenticated, and CDN-cached for one hour.

## `GET /api/catalog/docks`

* **Gate:** `public`
* **Read-only:** `true`
* **Destructive:** `false`
* **Idempotent:** `true`

## Parameters

| Name             | In    | Required | Type     | Description                                                        |
| ---------------- | ----- | -------- | -------- | ------------------------------------------------------------------ |
| `manufacturer`   | query | no       | `string` | Exact manufacturer name filter.                                    |
| `compatibleWith` | query | no       | `string` | An airframe catalog id; narrows to dock models compatible with it. |

## Responses

### `200` — Dock catalog rows.

Array of:

| Property                | Type              | Required | Constraints | Description                                                                                                                       |
| ----------------------- | ----------------- | -------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------- |
| `id`                    | `string`          | no       | —           |                                                                                                                                   |
| `manufacturer`          | `string`          | no       | —           |                                                                                                                                   |
| `model`                 | `string`          | no       | —           |                                                                                                                                   |
| `dockCategory`          | `string`          | no       | —           | Open set today limited to charging\|swapping; clients must tolerate additional values added in the future without a version bump. |
| `ndaaCompliant`         | `boolean`         | no       | —           |                                                                                                                                   |
| `countryOfManufacture`  | `string or null`  | no       | —           |                                                                                                                                   |
| `charging`              | `object`          | no       | —           |                                                                                                                                   |
| `swap`                  | `object`          | no       | —           |                                                                                                                                   |
| `turnaroundSeconds`     | `integer or null` | no       | —           |                                                                                                                                   |
| `physical`              | `object`          | no       | —           |                                                                                                                                   |
| `specs`                 | `any`             | no       | —           |                                                                                                                                   |
| `compatibleAirframeIds` | `array<string>`   | no       | —           |                                                                                                                                   |
| `oemUrl`                | `string or null`  | no       | —           |                                                                                                                                   |
| `sourceUrl`             | `string or null`  | no       | —           |                                                                                                                                   |
| `sourceCitedAt`         | `string or null`  | no       | —           |                                                                                                                                   |
| `sourceNotes`           | `string or null`  | no       | —           |                                                                                                                                   |

#### `charging`

| Property | Type              | Required | Constraints | Description |
| -------- | ----------------- | -------- | ----------- | ----------- |
| `method` | `string or null`  | no       | —           |             |
| `powerW` | `integer or null` | no       | —           |             |

#### `swap`

| Property      | Type              | Required | Constraints | Description |
| ------------- | ----------------- | -------- | ----------- | ----------- |
| `timeSeconds` | `integer or null` | no       | —           |             |
| `slotCount`   | `integer or null` | no       | —           |             |
| `mechanism`   | `string or null`  | no       | —           |             |

#### `physical`

| Property     | Type             | Required | Constraints | Description |
| ------------ | ---------------- | -------- | ----------- | ----------- |
| `weightKg`   | `number or null` | no       | —           |             |
| `ipRating`   | `string or null` | no       | —           |             |
| `opTempMinC` | `number or null` | no       | —           |             |
| `opTempMaxC` | `number or null` | no       | —           |             |

### `500` — Unhandled server error.

| Property | Type     | Required | Constraints | Description |
| -------- | -------- | -------- | ----------- | ----------- |
| `error`  | `string` | no       | —           |             |

## Errors

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