Skip to content
vessel-apiPublic

About

Real-time AIS vessel tracking & maritime data API — documentation, code examples, and community issue tracker.

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Latest commit

 

History

9 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

VesselAPI

Real-Time AIS Tracking & Maritime Data API

Access global vessel positions, port events, and maritime infrastructure through a simple REST API.

Documentation · API Explorer · Dashboard · Pricing · Contact

GitHub Issues Website


What is VesselAPI?

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

Features

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

Quick Start

Get Your API Key

  1. Sign up at dashboard.vesselapi.com
  2. Create an API key from your dashboard
  3. Start making requests

Your First Request

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}`));

API Endpoints

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.

Pricing

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

View full pricing details

Documentation

SDKs

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.

Community & Support

Getting Help

Reporting Issues

Found a bug or have a feature request?

Please search existing issues before creating a new one.

Feedback

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.

Security

Found a security vulnerability? Please report it responsibly via email to security@vesselapi.com. See SECURITY.md for details.


vesselapi.com · GitHub

© 2026 VesselAPI. All rights reserved. Not licensed for redistribution or reuse.

About

Real-time AIS vessel tracking & maritime data API — documentation, code examples, and community issue tracker.

Topics

Resources

Contributing

Security policy

Stars

3 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors