API v1.4 — Stable

HeyMariner Maritime API

REST API for maritime data — vessel tracking, port information, fleet statistics, route calculations and marine weather. JSON responses, API key authentication.

Quick Start

# Get vessel by IMO number

curl -H "X-API-Key: YOUR_API_KEY" \

https://api.heymariner.com/v1/vessels/9234194

{/* Response */}

"imo": "9234194",

"name": "EVER GIVEN",

"type": "Container Ship",

"flag": "Panama",

"gt": 219079,

"dwt": 199629

Starter

Free

1,000/day API requests

10 watched tracked

Vessel search

Basic vessel details

Port information

Professional

$49/month

50,000/day API requests

100 watched tracked

All Starter features

Real-time AIS positions

Historical tracks

Fleet statistics

Weather API

Enterprise

Custom

Unlimited API requests

Unlimited tracked

All Pro features

Bulk AIS feed

Dedicated support

SLA guarantee

Custom endpoints

API Endpoints

Method	Endpoint	Description	Rate Limit
GET	/v1/vessels/{imo}	Get vessel details by IMO number — name, type, flag, dimensions, owner	100/min
GET	/v1/vessels/{imo}/position	Real-time AIS position — lat, lon, speed, course, heading, destination	100/min
GET	/v1/vessels/{imo}/track	Historical vessel track — positions over time with configurable interval	20/min
GET	/v1/vessels/search	Search vessels by name, IMO, MMSI, call sign, type or flag	50/min
GET	/v1/ports/{port_id}	Port details — location, facilities, berths, pilotage, contacts	100/min
GET	/v1/ports/{port_id}/arrivals	Expected and actual vessel arrivals at a port (last 24h / next 24h)	50/min
GET	/v1/fleet/statistics	Global fleet statistics by vessel type, flag, age	10/min
GET	/v1/routes/distance	Calculate sea distance between two ports (nautical miles)	200/min
GET	/v1/weather/{lat}/{lon}	Marine weather at coordinates — wind, wave height, swell, pressure	100/min
POST	/v1/fleet/watch	Subscribe to position updates for a list of vessels (webhook)	10/min

Webhook Documentation MCP Server