Port lookup

Find a port by name, country, or UN/LOCODE (no key)

Resolves a port name to the UN/LOCODE that route.origin and route.destination require. Requires NO API key. Covers the ports the routing graph can compute against, so a code returned here is guaranteed to be routable. An exact LOCODE match is returned first, which makes this also the way to confirm a code you already hold. Every result carries match_score and match_type so a caller can tell a confident resolution from a weak one programmatically rather than trusting position in the list.

get/api/v1/ports

Request

  • Base URL: https://arcnautical.com
  • URL: https://arcnautical.com/api/v1/ports
  • Auth: none required

Query parameters

querystring required

Port name, country, or UN/LOCODE. Minimum two characters, case-insensitive, accents and spacing ignored. A port's official local or former name finds it too (lisboa, chattogram, antwerpen, bombay); the result carries the name we use.

limitinteger

Maximum ports to return.

Response

Matching ports, best match first. An empty array means no port matched.

Changes

No recorded changes to this operation across all 1 revision of this API.