> ## 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 visible docks

> Lists Dock resources visible to the caller: with `?mine=true` (or always, for a demo session) the caller's own org-owned docks at any access mode; otherwise every globally-open dock plus `shared` docks in networks the caller has joined (`private` docks of other orgs are never returned). Use `?mine=true` for an owner's fleet management view and omit it for the marketplace/browse view. Supply is presently ~6.3K leftover synthetic rows plus any real docks created via docks_create — there is no live occupancy (`?at=` is not implemented; `status` is a stored value).

## `GET /api/docks`

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

## Parameters

| Name   | In    | Required | Type     | Description                                                             |
| ------ | ----- | -------- | -------- | ----------------------------------------------------------------------- |
| `mine` | query | no       | `string` | 'true' to scope to the caller's own org-owned docks at any access mode. |

## Responses

### `200` — Visible docks.

Array of:

| Property         | Type     | Required | Constraints       | Description                                                                                |
| ---------------- | -------- | -------- | ----------------- | ------------------------------------------------------------------------------------------ |
| `id`             | `string` | no       | —                 |                                                                                            |
| `callsign`       | `string` | no       | —                 | Two-word callsign: the stored slug for real docks, derived from the id for synthetic rows. |
| `name`           | `string` | no       | —                 |                                                                                            |
| `rooftop`        | `object` | no       | —                 | The dock's Site (legacy name retained).                                                    |
| `latitude`       | `number` | no       | —                 |                                                                                            |
| `longitude`      | `number` | no       | —                 |                                                                                            |
| `status`         | `string` | no       | —                 | Open set; stored status only, not derived from live occupancy.                             |
| `pricePerMinute` | `number` | no       | —                 |                                                                                            |
| `createdAt`      | `string` | no       | format: date-time |                                                                                            |
| `earningsToDate` | `number` | no       | —                 | Always 0 until the v2 booking backend lands.                                               |

#### `rooftop`

| Property  | Type     | Required | Constraints | Description |
| --------- | -------- | -------- | ----------- | ----------- |
| `id`      | `string` | no       | —           |             |
| `address` | `string` | no       | —           |             |

### `401` — Not signed in.

| Property            | Type      | Required | Constraints           | Description                                                                                                                                                                                                       |
| ------------------- | --------- | -------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`              | `string`  | yes      | format: uri-reference |                                                                                                                                                                                                                   |
| `status`            | `integer` | yes      | —                     |                                                                                                                                                                                                                   |
| `title`             | `string`  | yes      | —                     |                                                                                                                                                                                                                   |
| `detail`            | `string`  | no       | —                     |                                                                                                                                                                                                                   |
| `instance`          | `string`  | no       | —                     |                                                                                                                                                                                                                   |
| `code`              | `string`  | yes      | —                     |                                                                                                                                                                                                                   |
| `field`             | `string`  | no       | —                     |                                                                                                                                                                                                                   |
| `error`             | `string`  | no       | —                     | Legacy-compat mirror of `detail` (or `title` when no `detail` is given), added by apiProblemResponse (lib/problem.ts) so pre-C2 consumers reading `.error` off a live route's error body keep working unmodified. |
| `documentation_url` | `string`  | no       | —                     |                                                                                                                                                                                                                   |
| `request_id`        | `string`  | no       | —                     |                                                                                                                                                                                                                   |

### `500` — Session/auth resolution error, or unhandled server error.

| Property            | Type      | Required | Constraints           | Description                                                                                                                                                                                                       |
| ------------------- | --------- | -------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `type`              | `string`  | yes      | format: uri-reference |                                                                                                                                                                                                                   |
| `status`            | `integer` | yes      | —                     |                                                                                                                                                                                                                   |
| `title`             | `string`  | yes      | —                     |                                                                                                                                                                                                                   |
| `detail`            | `string`  | no       | —                     |                                                                                                                                                                                                                   |
| `instance`          | `string`  | no       | —                     |                                                                                                                                                                                                                   |
| `code`              | `string`  | yes      | —                     |                                                                                                                                                                                                                   |
| `field`             | `string`  | no       | —                     |                                                                                                                                                                                                                   |
| `error`             | `string`  | no       | —                     | Legacy-compat mirror of `detail` (or `title` when no `detail` is given), added by apiProblemResponse (lib/problem.ts) so pre-C2 consumers reading `.error` off a live route's error body keep working unmodified. |
| `documentation_url` | `string`  | no       | —                     |                                                                                                                                                                                                                   |
| `request_id`        | `string`  | no       | —                     |                                                                                                                                                                                                                   |

## Errors

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