Access global vessel positions, port events, and maritime infrastructure through a simple REST API.
Documentation · API Explorer · Dashboard · Pricing · Contact
VesselAPI provides a unified REST API for accessing real-time maritime data. Instead of integrating and maintaining multiple data sources yourself, you get a single API endpoint with normalised, reliable data.
Built for:
- Maritime research and analytics
- Trade flow analysis
- Fleet monitoring and tracking
- Port operations intelligence
- Supply chain visibility
| Feature | Description | Availability |
|---|---|---|
| Vessel Positions | Real-time AIS positions updated continuously | All plans |
| Vessel Search | Search by name or callsign | All plans |
| ETA & Destinations | Estimated arrival times and reported destinations | All plans |
| Port Events | Vessel arrivals and departures at ports worldwide | All plans |
| Navigation Infrastructure | DGPS stations, light aids, radio beacons, MODUs | All plans |
| World Port Index | Comprehensive database of global ports | All plans |
| Marine Casualties | Casualty records and incident data | All plans |
| Vessel Emissions | CO2 output, fuel consumption, energy efficiency metrics | All plans |
- Sign up at dashboard.vesselapi.com
- Create an API key from your dashboard
- Start making requests
cURL
curl -X GET "https://api.vesselapi.com/v1/search/vessels?filter.name=EVERGREEN" \
-H "Authorization: Bearer YOUR_API_KEY"Python
import requests
response = requests.get(
"https://api.vesselapi.com/v1/search/vessels",
params={"filter.name": "EVERGREEN"},
headers={"Authorization": "Bearer YOUR_API_KEY"}
)
payload = response.json()
for vessel in payload["vessels"]:
print(f"{vessel['name']} - MMSI: {vessel['mmsi']}")JavaScript
const response = await fetch(
"https://api.vesselapi.com/v1/search/vessels?filter.name=EVERGREEN",
{
headers: { Authorization: "Bearer YOUR_API_KEY" }
}
);
const { vessels } = await response.json();
vessels.forEach(v => console.log(`${v.name} - MMSI: ${v.mmsi}`));| Category | Endpoint | Description |
|---|---|---|
| Vessels | GET /v1/vessel/{id} |
Get vessel details (requires filter.idType) |
| Vessels | GET /v1/vessel/{id}/position |
Get current AIS position (requires filter.idType) |
| Vessels | GET /v1/vessel/{id}/eta |
Get ETA and destination (requires filter.idType) |
| Vessels | GET /v1/vessels/positions |
Get positions for multiple vessels (requires filter.ids and filter.idType) |
| Vessels | GET /v1/search/vessels |
Search vessels by name or callsign |
| Vessels | GET /v1/location/vessels/radius |
Find vessels within radius (requires filter.longitude, filter.latitude, filter.radius) |
| Vessels | GET /v1/location/vessels/bounding-box |
Find vessels in geographic area (requires filter.lonLeft, filter.lonRight, filter.latBottom, filter.latTop) |
| Ports | GET /v1/port/{unlocode} |
Get port details |
| Ports | GET /v1/port/{unlocode}/inbound |
Get vessels inbound to a port, with reported ETAs |
| Ports | GET /v1/search/ports |
Search ports by name |
| Ports | GET /v1/location/ports/radius |
Find ports within radius (requires filter.longitude, filter.latitude, filter.radius) |
| Ports | GET /v1/location/ports/bounding-box |
Find ports in geographic area (requires filter.lonLeft, filter.lonRight, filter.latBottom, filter.latTop) |
| Port Events | GET /v1/portevents |
Get port events by time range |
| Port Events | GET /v1/portevents/port/{unlocode} |
Get events for a specific port |
| Port Events | GET /v1/portevents/vessel/{id} |
Get port call history for a vessel (requires filter.idType) |
| Port Events | GET /v1/portevents/vessel/{id}/last |
Get last port event for a vessel (requires filter.idType) |
| Navigation | GET /v1/search/lightaids |
Search lighthouses and light aids (requires filter.name) |
| Navigation | GET /v1/search/radiobeacons |
Search radio beacons (requires filter.name) |
| Navigation | GET /v1/search/dgps |
Search DGPS stations (requires filter.name) |
| Navigation | GET /v1/search/modus |
Search offshore drilling units (requires filter.name) |
| Vessels | GET /v1/vessel/{id}/casualties |
Get marine casualty records (requires filter.idType) |
| Vessels | GET /v1/vessel/{id}/emissions |
Get emissions for a specific vessel (requires filter.idType) |
| Emissions | GET /v1/emissions |
Get vessel emissions data (global) |
| Port Events | GET /v1/portevents/ports |
Search port events by port name (requires filter.portName) |
| Port Events | GET /v1/portevents/vessels |
Search port events by vessel name (requires filter.vesselName) |
All location and navigation endpoints also support bounding-box and radius queries. See full docs.
| Plan | Price | Requests/Month |
|---|---|---|
| Free | $0/mo | 150 |
| Basic | $14.99/mo | 1,500 |
| Starter | $59.99/mo | 15,000 |
| Growth | $159.99/mo | 30,000 |
| Pro | $249.99/mo | Millions/mo |
- Pro: millions of calls per month, up to 10 requests/second
- Every plan includes every endpoint; tiers differ by monthly call volume, not features
- 14-day money-back guarantee
- No long-term contracts
- All plans are self-service. Sign up at dashboard.vesselapi.com
| Language | Package | Install |
|---|---|---|
| Go | vesselapi-go | go get github.com/vessel-api/vesselapi-go/v4 |
| Python | vesselapi-python | pip install vessel-api-python |
| TypeScript | vesselapi-ts | npm install vesselapi |
ctx := context.Background()
client, _ := vesselapi.NewVesselClient(os.Getenv("VESSELAPI_API_KEY"))
result, _ := client.Search.Vessels(ctx, &vesselapi.GetSearchVesselsParams{
FilterName: vesselapi.Ptr("Ever Given"),
})
for _, v := range *result.Vessels {
fmt.Printf("%s - MMSI: %d\n", vesselapi.Deref(v.Name), vesselapi.Deref(v.Mmsi))
}from vessel_api_python import VesselClient
client = VesselClient(api_key="your-api-key")
result = client.search.vessels(filter_name="Ever Given")
for v in result.vessels or []:
print(f"{v.name} (IMO {v.imo})")import { VesselClient } from "vesselapi";
const client = new VesselClient("your-api-key");
const { vessels } = await client.search.vessels({ filterName: "Ever Given" });
for (const v of vessels ?? []) {
console.log(`${v.name} (IMO ${v.imo})`);
}MCP server: vesselapi-mcp exposes the API to AI assistants such as Claude Desktop, Claude Code, Cursor and Windsurf. No install step: point your client at npx vesselapi-mcp.
All SDKs include automatic retries with backoff, iterators for pagination, and typed error handling. See the Go SDK README, Python SDK README, and TypeScript SDK README for full documentation.
- Documentation: vesselapi.com/docs
- API Reference: vesselapi.com/api-reference
- Email Support: support@vesselapi.com (24-48h response, Mon-Fri 9am-5pm CET)
Found a bug or have a feature request?
Please search existing issues before creating a new one.
Bug reports, feature requests and documentation corrections are welcome via the issue tracker. See CONTRIBUTING.md.
This repository does not accept external code contributions. It carries no open-source licence, so there are no terms under which contributed code could be accepted. Open an issue instead and we will pick it up from there.
Found a security vulnerability? Please report it responsibly via email to security@vesselapi.com. See SECURITY.md for details.
© 2026 VesselAPI. All rights reserved. Not licensed for redistribution or reuse.