Berth KPIs
Production
https://api.polestar-production.com
Production
https://api.polestar-production.com
GET
https://api.polestar-production.com
and per-berth dwell-time statistics (min/avg/median/max hours at berth).
Berths are grouped by terminal operator. Dwell times are computed from the
arrival_time and departure_time of vessel visit records that fall withinthe selected date range.
Path parameter: id_type
| Value | Meaning |
|---|---|
id | Internal port UUID (e.g. c750eef6-52c0-4c96-9def-90f7eb8914b4) |
unlocode | UN/LOCODE (e.g. NLRTM) |
Filters
date_start / date_end: inclusive ISO-8601 (yyyy-MM-dd) date range.berth_type (optional): list of structural berth types to filter by(e.g.
Quay, Jetty).terminal_name (optional): list of terminal operator names to filter by.Error codes
| Code | HTTP | Condition |
|---|---|---|
| ERROR_300 | 400 | date_start is after date_end |
| ERROR_301 | 400 | id_type is not id or unlocode |
| ERROR_302 | 404 | No port found for the given identifier |
| ERROR_303 | 400 | Date range exceeds 2 years |
| ERROR_304 | 400 | date_start is before 2025-01-01 (historical data start) |
Request
Path Params
Query Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.polestar-production.com/maritime-analytics/v1/analytics/ports/unlocode/PABLB/berths?date_start=2026-04-17&date_end=2026-04-23&berth_type=Quay&terminal_name=Panama%20Ports%20Co.&limit=undefined&offset=undefined' \
--header 'api-key: <api-key>'Response Response Example
200 - Berth KPIs for Rotterdam, September 2026
{
"meta": {
"request_id": "8417a80a-1662-4171-8758-c175a9dc2506",
"request_timestamp": "2026-09-30T10:30:03Z",
"limit": 500,
"offset": 0,
"total": 269
},
"query": {
"date_start": "2026-09-01",
"date_end": "2026-09-28",
"berth_type": [],
"terminal_name": []
},
"port_information": {
"id": "c750eef6-52c0-4c96-9def-90f7eb8914b4",
"name": "Rotterdam",
"unlocode": "NLRTM",
"country": "Netherlands"
},
"kpi": {
"total_berths": 269,
"min_dwell_time": 0.33,
"max_dwell_time": 481.33,
"terminal_operators": 62
},
"terminals": [
{
"terminal_name": "SCA Logistics Terminal",
"berths": [
{
"berth_id": "77c8087f-8be5-4b27-bce0-1a9da2fa3dc2",
"berth_name": "SCA Ro-Ro",
"berth_status": "Active",
"berth_type": "Quay",
"berth_facility": "Dry Cargo",
"length_m": 168,
"max_loa_m": 171,
"max_dwt": 15000,
"depth_lw_m": 8,
"min_dwell_time": 2.05,
"avg_dwell_time": 7.36,
"median_dwell_time": 7.49,
"max_dwell_time": 15.4,
"vessel_types": [
{
"ship_type_level_3": "General cargo",
"visit_count": 8,
"proportion": 0.67
},
{
"ship_type_level_3": "Oil tanker",
"visit_count": 3,
"proportion": 0.25
},
{
"ship_type_level_3": "Chemical Tanker",
"visit_count": 1,
"proportion": 0.08
}
]
}
]
},
{
"terminal_name": "Vopak Terminal Chemiehaven (Rotterdam)",
"berths": [
{
"berth_id": "5c6f65f8-695d-4f77-a992-69012a27938e",
"berth_name": "Jetty No. 01 (Outside)",
"berth_status": "Active",
"berth_type": "L Jetty",
"berth_facility": "Tanker",
"length_m": 118,
"max_loa_m": 220,
"max_dwt": 40000,
"depth_lw_m": 11.95,
"min_dwell_time": 2.28,
"avg_dwell_time": 11.99,
"median_dwell_time": 8.59,
"max_dwell_time": 25.12,
"vessel_types": [
{
"ship_type_level_3": "Oil tanker",
"visit_count": 10,
"proportion": 0.91
},
{
"ship_type_level_3": "Chemical Tanker",
"visit_count": 1,
"proportion": 0.09
}
]
},
{
"berth_id": "ada97b9e-e463-4550-abc4-502a23dbcd88",
"berth_name": "Jetty No. 03",
"berth_status": "Active",
"berth_type": "Jetty",
"berth_facility": "Tanker",
"length_m": 195,
"max_loa_m": 176.75,
"max_dwt": 37205,
"depth_lw_m": 11.95,
"min_dwell_time": 1.11,
"avg_dwell_time": 30.49,
"median_dwell_time": 14.43,
"max_dwell_time": 75.94,
"vessel_types": [
{
"ship_type_level_3": "Oil tanker",
"visit_count": 2,
"proportion": 0.67
},
{
"ship_type_level_3": "Chemical Tanker",
"visit_count": 1,
"proportion": 0.33
}
]
},
{
"berth_id": "0f523441-742d-4da3-816c-71b05bceb3e4",
"berth_name": "Jetty No. 04",
"berth_status": "Active",
"berth_type": "Jetty",
"berth_facility": "Tanker",
"length_m": 196,
"max_loa_m": 178,
"max_dwt": 20000,
"depth_lw_m": 11.95,
"min_dwell_time": 13.38,
"avg_dwell_time": 14.94,
"median_dwell_time": 14.94,
"max_dwell_time": 16.51,
"vessel_types": [
{
"ship_type_level_3": "Chemical Tanker",
"visit_count": 1,
"proportion": 0.5
},
{
"ship_type_level_3": "Oil tanker",
"visit_count": 1,
"proportion": 0.5
}
]
}
]
}
]
}Modified at 2026-10-21 13:57:11