> ## 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.

# Congestion

> Query port congestion indices, vessel wait time trends, and queue-depth time series across major global ports — for supply chain analytics and route planning.

Port congestion indices and wait time trends.

## `GET` `/api/v1/congestion`

Latest congestion snapshot for all ports or a specific port.

**Parameters**

| Name          | Type   | Required | Description           |
| ------------- | ------ | -------- | --------------------- |
| `port`        | string |          | Port slug             |
| `vessel_type` | string |          | Filter by vessel type |

**Response**

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

**Example**

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

## `GET` `/api/v1/congestion/history`

Historical congestion data for a port.

**Parameters**

| Name          | Type   | Required | Description           |
| ------------- | ------ | -------- | --------------------- |
| `port`        | string | ✓        | Port slug             |
| `days`        | number |          | Default 30, max 365   |
| `vessel_type` | string |          | Filter by vessel type |

**Response**

```json theme={null}
{ "port", "port_name", "days", "vessel_type", "history" }
```

**Example**

```bash theme={null}
curl -X GET \
  https://axiomoverwatch.io/api/v1/congestion/history?port=VALUE&days=VALUE
```

## `POST` `/api/v1/congestion/refresh`

<Note>Requires API key.</Note>

Trigger congestion index recomputation.

**Response**

```json theme={null}
{ "success", "result" }
```

**Example**

```bash theme={null}
curl -X POST -H "X-API-Key: YOUR_KEY" \
  https://axiomoverwatch.io/api/v1/congestion/refresh \
  -d '{"key":"value"}'
```