Port Distance API — NeoBulk Carriers

Simple, transparent pricing

Start free. Scale as you grow. No setup fees.

FREE

$0 /mo

✅ 100 requests / day
✅ 1,000 requests / month
✅ Full JSON response
✅ DB cache (fast repeat)
❌ ECA zone detail
❌ Email support

Get Free Key

BASIC

$29 /mo

✅ 1,000 requests / day
✅ 10,000 requests / month
✅ Full JSON response
✅ ECA zone detail
✅ Canal restrictions
❌ Priority support

Get Basic Key

PRO Most Popular

$99 /mo

✅ 10,000 requests / day
✅ 100,000 requests / month
✅ Full JSON response
✅ ECA + piracy zones
✅ Canal restrictions
✅ Priority email support

Get Pro Key

ENTERPRISE

Custom

✅ Unlimited requests
✅ SLA guarantee
✅ Custom integration help
✅ Dedicated support
✅ Invoice billing
✅ White-label option

Contact Us

Quickstart

Three steps to your first sea route calculation.

1. Get your API key

Email info@neobulkcarriers.com with your company name and intended use case. We'll send your key within 24 hours.

2. Make your first request

curl -X GET \ "https://neobulkcarriers.com/api/distance_public.php" \ -H "X-Api-Key: nbk_your_key_here" \ -G \ --data-urlencode "from_port=Fujairah" \ --data-urlencode "to_port=Singapore" \ --data-urlencode "from=56.3417,25.1288" \ --data-urlencode "to=103.8198,1.3521"

3. Parse the response

{
  "ok": true,
  "from_port": "Fujairah",
  "to_port": "Singapore",
  "distance_nm": 3241.7,
  "distance_eca_nm": 142.3,
  "duration_hours": 281.9,
  "gateways_used": "auto",
  "traversed": ["Strait of Malacca"],
  "eca_zones": [],
  "piracy_zones": ["Gulf of Aden"],
  "canal_restrictions": [],
  "source": "calculated",
  "plan": "pro",
  "response_ms": 847
}
    

Code samples

import requests

response = requests.get(
    "https://neobulkcarriers.com/api/distance_public.php",
    headers={"X-Api-Key": "nbk_your_key_here"},
    params={
        "from_port": "Fujairah",
        "to_port":   "Singapore",
        "from":       "56.3417,25.1288",
        "to":         "103.8198,1.3521",
    }
)
data = response.json()
print(f"Distance: {data['distance_nm']} nm")
    

const params = new URLSearchParams({
    from_port: "Fujairah",
    to_port:   "Singapore",
    from:      "56.3417,25.1288",
    to:        "103.8198,1.3521",
});

const res = await fetch(
    `https://neobulkcarriers.com/api/distance_public.php?${params}`,
    { headers: { "X-Api-Key": "nbk_your_key_here" } }
);
const data = await res.json();
console.log(`Distance: ${data.distance_nm} nm`);
    

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://neobulkcarriers.com/api/distance_public.php?'
        . http_build_query([
            'from_port' => 'Fujairah',
            'to_port'   => 'Singapore',
            'from'       => '56.3417,25.1288',
            'to'         => '103.8198,1.3521',
        ]),
    CURLOPT_HTTPHEADER     => ['X-Api-Key: nbk_your_key_here'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
echo $data['distance_nm'] . ' nm';
    

API Reference

Endpoint

GET or POST https://neobulkcarriers.com/api/distance_public.php

Authentication

Pass your key as an HTTP header X-Api-Key (preferred) or as a query parameter ?key=.

Request Parameters

Parameter	Type	Required	Description
from_port	string	Required	Departure port name (for logging & display)
to_port	string	Required	Destination port name
from	string	Required	Departure coordinates as `"longitude,latitude"`
to	string	Required	Destination coordinates as `"longitude,latitude"`
gateways	string	Optional	Force routing through canals: `suez`, `panama`, `kiel` (comma-separated)
speed_knot	float	Optional	Vessel speed in knots. Default: `11.5`

Response Fields

Field	Type	Description
ok	bool	`true` on success
distance_nm	float	Total sea distance in nautical miles
distance_eca_nm	float	Distance within ECA (Emission Control Area) zones
duration_hours	float	Estimated voyage duration at requested speed
gateways_used	string	Canals the route passes through, or `"auto"`
traversed	array	Named straits and passages on the route
eca_zones	array	ECA zones encountered
piracy_zones	array	High-risk piracy areas on route
canal_restrictions	array	Canal size/draft restrictions relevant to route
source	string	`calculated` (live) or `cache` (from DB, instant)
response_ms	int	Server response time in milliseconds

Error Codes

HTTP Code	Error	Meaning
200	—	Success
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Missing or invalid API key
403	Forbidden	Key disabled or expired
429	Too Many Requests	Daily or monthly limit reached
502	Calculation Failed	Route could not be computed (very rare)

// Error response shape
{
  "ok": false,
  "error": "Daily limit reached.",
  "daily_limit": 100,
  "used_today": 100,
  "resets_at": "2026-04-04 00:00:00 UTC+0 (midnight)"
}
    

Port-to-Port Distance API LIVE