Sea route & distance API

The endpoint

curl "https://marine-os-lime.vercel.app/api/v1/searoute?from=SGSIN&to=NLRTM&speed=14&geometry=1" \
  -H "Authorization: Bearer mos_your_key"

{
  "from": { "name": "Singapore", "code": "SGSIN", "lat": 1.26, "lng": 103.83 },
  "to":   { "name": "Rotterdam", "code": "NLRTM", "lat": 51.92, "lng": 4.50 },
  "distance": { "nm": 8439.2, "km": 15629.4, "mi": 9711.7 },
  "hours": 602.8,
  "passages": ["malacca", "suez", "gibraltar", "dover"],
  "geometry": { "type": "LineString", "coordinates": [[103.83, 1.26], ...] }
}

POST with a JSON body is also supported. Every response carries an X-Quota-Remaining header.

Voyage estimation endpoint

For chartering desks and voyage-estimation tools: one call returns distance, steaming time, bunker consumption and cost — and when you pass freight and cargo, voyage revenue, TCE (time charter equivalent), and the voyage result. All economic inputs are optional; send what you have, get back what can be computed.

curl "https://marine-os-lime.vercel.app/api/v1/voyage?from=CNSHA&to=NLRTM&speed=12.5&consumption=28\
&bunker_price=560&port_days=4&freight_rate=42&cargo=55000&other_costs=180000" \
  -H "Authorization: Bearer mos_your_key"

{
  "distance": { "nm": 10587.3, "km": 19607.7, "mi": 12183.6 },
  "passages": ["malacca", "suez", "gibraltar", "dover"],
  "time": { "seaDays": 35.29, "portDays": 4, "totalDays": 39.29, "seaHours": 847.0 },
  "bunkers": { "seaMt": 988.1, "portMt": 0, "totalMt": 988.1, "costUsd": 553337 },
  "economics": {
    "revenueUsd": 2310000, "bunkerCostUsd": 553337, "otherCostsUsd": 180000,
    "tceUsdPerDay": 40128, "voyageResultUsd": null
  },
  "assumptions": { "speedKnots": 12.5, "consumptionMtPerDay": 28, ... }
}

TCE = (revenue − bunker cost − other costs) ÷ total voyage days. Voyage estimation calls count against the same monthly quota. Want to eyeball a distance first? Use the free sea distance calculator.

Emissions & EU compliance endpoint

/api/v1/emissions returns, for any port pair: emissions by gas (CO₂/CH₄/N₂O), EU ETS allowances due under the 2026 rules with euro cost at your EUA price, FuelEU Maritime balance and penalty exposure, and an indicative CII rating. Included in every plan — full documentation on the Voyage Emissions API page, or try the free EU ETS calculator.

In your language

import requests

r = requests.get(
    "https://marine-os-lime.vercel.app/api/v1/searoute",
    params={"from": "SGSIN", "to": "NLRTM", "speed": 14},
    headers={"Authorization": "Bearer mos_your_key"},
)
route = r.json()
print(route["distance"]["nm"], "nm,", route["hours"], "h")

const res = await fetch(
  "https://marine-os-lime.vercel.app/api/v1/searoute?from=SGSIN&to=NLRTM&speed=14",
  { headers: { Authorization: "Bearer mos_your_key" } }
)
const route = await res.json()
console.log(route.distance.nm, "nm,", route.hours, "h")

How the pricing compares

Sea distance APIs are priced all over the map. Public list prices as of August 2026 (verify with each vendor):

Providers differ in what they model (ECA zones, vessel-specific constraints, emissions methodology). If you need planning-grade port-to-port distances, times, and geometry, run the same queries against a trial key of each and compare numbers and cost. Our sea distance API guide walks through the whole provider landscape.

Pricing

Want to test first? Email support.marineos@gmail.com for a free 100-call trial key. Comparable sea-distance APIs list from roughly 400 EUR per month, so run the same queries against both and compare.

Honest scope

Distances are computed over the open Eurostat maritime network: realistic, planning-grade port-to-port figures of the kind freight tools publish. It is not a weather-routed or draft-optimized voyage plan, and it is not for navigation. If you need to sanity-check the output, our free sea distance pages publish the same engine's numbers for 56 known routes.

Frequently asked questions