grandline

Port Distances

Every cached destination reachable from port_id, with the distance for the chosen variant — paginated and sorted shortest-first.

"Show me everywhere a vessel can sail from Mundra and how far." For voyage analytics, rate-card builders, and port authorities. One metered call per request (not per row). The empirical via_* leak guard (known-issue #1) applies; the U-004 Cape estimate does not — this bulk listing reports measured distances only, so a via_cape with no cached value comes back distance_nm: null with an availability reason.

get/api/v1/ports/{port_id}/distances

Request

  • Base URL: https://grandline.luzomi.com
  • URL: https://grandline.luzomi.com/api/v1/ports/{port_id}/distances
  • Auth: none declared

Path parameters

port_idinteger required

Query parameters

variantstring

primary/via_suez/via_panama/via_cape.

country_iso2string nullable

Optional — only destinations in this country.

limitinteger
offsetinteger

Response

Successful Response

origin_port_idinteger required
origin_port_namestring required
variantstring required
totalinteger required
limitinteger required
offsetinteger required

Changes

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