GET /api/v1/ports

List ports

Ports in UN/LOCODE order, optionally for one country. Coordinates are included per row only when their source (UN/LOCODE, NGA World Port Index, Wikidata) permits API use.

1 creditKey required

Parameters
Name	In	Description
country	query	ISO 3166-1 alpha-2 country code.
limit	query	Rows per page, 1 to 100 (default 50).
cursor	query	Opaque cursor: use the "next" URL of the previous page.

Request

curl -H "Authorization: Bearer $SEADAR_API_KEY" \
  https://www.voydar.com/api/v1/ports?country=NL&limit=2

Response (abridged)

{
  "type": "port_list",
  "apiVersion": "1",
  "count": 2,
  "data": [
    { "unlocode": "NLAMS", "name": "Amsterdam", "country": "NL", "coordinates": { "lat": 52.4, "lon": 4.82, "source": "unlocode" },
      "api": "https://www.voydar.com/api/v1/ports/nlams" },
    { "unlocode": "NLRTM", "name": "Rotterdam", "country": "NL", "coordinates": { "lat": 51.9, "lon": 4.5, "source": "nga_wpi" },
      "api": "https://www.voydar.com/api/v1/ports/nlrtm" }
  ],
  "next": "https://www.voydar.com/api/v1/ports?country=NL&limit=2&cursor=NLRTM",
  "withheld": [],
  "attribution": [ "…" ], "license": [ "…" ], "sources": ["nga_wpi", "unlocode"]
}