Zone & Port Search

Production

https://api.polestar-production.com

GET

/zone-port-insights/v1/zones

Returns zones and ports in one paginated list. This is the unified definition search; the response carries the same port-shaped record for both kinds.

Request

Authorization

API Key

Add parameter in header

api-key

Example:

api-key: ********************

Query Params

Responses

🟢200OK

application/json

Zones and ports matching the filters. data is an empty array when none match.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠422Parameter Error

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/zone-port-insights/v1/zones?offset=undefined&limit=undefined&name_contains=Starigrad&country_code=HRV&sub_division_code=undefined&unlocode=HRSGR&wpi_number=undefined&types=undefined&sub_type=undefined' \
--header 'api-key: <api-key>'

Response Example

200 - Zones whose name contains "rotterdam"

{
    "meta": {
        "limit": 1,
        "offset": 0,
        "total_count": 8,
        "request_id": "c37ece29-3646-4b2c-b504-edaf68d226b2",
        "request_timestamp": "2026-09-30T10:30:01Z",
        "zone_version": "0.8.2"
    },
    "data": [
        {
            "centroid": {
                "longitude": 4.187014,
                "latitude": 51.925543
            },
            "country_official_name": "Kingdom of the Netherlands",
            "country_code": "NLD",
            "description": "",
            "id": "c750eef6-52c0-4c96-9def-90f7eb8914b4",
            "name": "Rotterdam",
            "sub_type": "Port",
            "type": "Ports",
            "unlocode": "NLRTM",
            "country_common_name": "Netherlands",
            "sub_division_code": "NL-ZH",
            "sub_division_name": "Zuid-Holland",
            "wpi_number": 31140
        }
    ]
}

Modified at 2026-10-21 13:57:11

Overview

Get Single Zone or Port