Search vessels

GET/v1/vessels/search1 credit per vessel

Find vessels by name or MMSI prefix among the vessels we have heard. Each comes with her last position from a source we may pass on, or with position_withheld: true. Order by distance with around.

Parameters

Name	Description
`q`required string	Name or MMSI prefix, at least 2 characters.
`around` lat,lon	Order the results by distance from this point.
`limit` integer	Up to 50. Default 20.

curl "https://gangwayais.com/v1/vessels/search?q=EXAMPLE" \
  -H "Authorization: Bearer $GANGWAY_KEY"

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [
          5.31,
          60.39
        ]
      },
      "properties": {
        "mmsi": 257753000,
        "name": "EXAMPLE FERRY",
        "type": 60,
        "length": 124,
        "flag": "NO",
        "sog": 12.4,
        "cog": 211,
        "heading": 210,
        "nav_status": 0,
        "destination": "BERGEN",
        "seen": "2026-11-01T12:58:00Z",
        "source": "barentswatch"
      }
    },
    {
      "type": "Feature",
      "geometry": null,
      "properties": {
        "mmsi": 244000777,
        "name": "EXAMPLE CARRIER",
        "type": 70,
        "length": 180,
        "flag": "NL",
        "sog": null,
        "cog": null,
        "heading": null,
        "nav_status": null,
        "seen": null,
        "source": null,
        "position_withheld": true
      }
    }
  ],
  "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."
}