Gangway AISGangway AISby Motto Marine International
DOCS · API v1
CoverageHomeSign inGet API key
Vessels

Vessel track

GET/v1/vessels/{mmsi}/track1 credit per vessel-day

Recorded positions for one vessel from sources we may pass on, as broadcast and never interpolated: time, latitude, longitude, speed, course and heading.

Parameters

NameDescription
mmsirequired
integer
In the path.
hours
integer
Up to 144 on the free API allowance (7 days back from now, its answers ending 24 hours ago), 2160 (90 days) on Plus, 8760 (12 months) on Pro and Scale. Default 72.
from, to
ISO 8601
A time window instead of hours, within the same reach: 7 days back from now on the free API allowance.
format
json | geojson | gpx
Default json. GPX is on paid plans: on the free API allowance it answers 402.
curl "https://gangwayais.com/v1/vessels/257753000/track?hours=6" \
  -H "Authorization: Bearer $GANGWAY_KEY"
{
  "mmsi": 257753000,
  "hours": 6,
  "from": "2026-11-01T07:00:00Z",
  "to": "2026-11-01T13:00:00Z",
  "history_since": "2026-10-07T00:00:00Z",
  "note": null,
  "points": [
    {
      "time": "2026-11-01T07:01:10Z",
      "lat": 60.39,
      "lon": 5.31,
      "sog": 12.4,
      "cog": 211,
      "heading": 210,
      "source": "barentswatch"
    },
    {
      "time": "2026-11-01T07:04:20Z",
      "lat": 60.38,
      "lon": 5.3,
      "sog": 12.1,
      "cog": 208,
      "heading": 207,
      "source": "barentswatch"
    }
  ],
  "attribution": {
    "barentswatch": "Gangway AIS (https://gangway.app). Data delivered by BarentsWatch. Contains data under the Norwegian licence for Open Government data (NLOD) distributed by the Norwegian Coastal Administration."
  },
  "notice": "Not for navigation. AIS data can be missing, delayed or wrong. Never use it for navigation, collision avoidance, search and rescue or any safety-of-life decision."
}