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

# Berth Utilization

> Query berth occupancy rates, turnaround times, and vessel-by-vessel berth utilization across monitored ports — endpoints for terminal performance analytics.

Berth occupancy rates and turnaround times.

<Tip>
  For a per-visit breakdown of how arrival-to-departure time was spent (approach, anchor wait, berth, idle), see [Voyage time allocation](/overwatch/methodology/voyage-time-allocation).
</Tip>

## `GET` `/api/v1/berth-utilization`

Latest berth utilization snapshots.

**Parameters**

| Name   | Type   | Required | Description |
| ------ | ------ | -------- | ----------- |
| `port` | string |          | Port slug   |

**Response**

```json theme={null}
{ "berth_utilization": [...] }
```

**Example**

```bash theme={null}
curl -X GET \
  https://axiomoverwatch.io/api/v1/berth-utilization?port=VALUE
```

## `GET` `/api/v1/berth-utilization/weekly`

Weekly berth utilization trends for a port.

**Parameters**

| Name      | Type   | Required | Description        |
| --------- | ------ | -------- | ------------------ |
| `port`    | string | ✓        | Port slug          |
| `zone_id` | string |          | Specific zone ID   |
| `weeks`   | number |          | Default 12, max 52 |

**Response**

```json theme={null}
{ "port", "port_name", "port_country", "weeks", "berth_utilization_weekly" }
```

**Example**

```bash theme={null}
curl -X GET \
  https://axiomoverwatch.io/api/v1/berth-utilization/weekly?port=VALUE&zone_id=VALUE
```