Vessels
Vessels in an area
GET/v1/vessels1 credit per vessel
Live vessels inside a box as GeoJSON, each with its source and the credit it needs. Only vessels whose position comes from a source we may pass on so an area answer has vessels in the areas on the Coverage page.
Parameters
| Name | Description |
|---|---|
bboxrequiredmin_lat,min_lon,max_lat,max_lon | The area. Up to 1 square degree on the free API allowance, 4 on Plus, 25 on Pro and 100 on Scale. |
max_ageduration | 90m, 24h or 7d. Default 24h. |
typeinteger | ITU ship type; a code ending in 0 matches its decade (80 = all tankers). |
min_sogknots | Only vessels at or above this speed. |
limitinteger | The newest this many, 1 to 5000. Only the vessels sent are paid for and truncated says whether more were left out. Without it the whole area. |
curl "https://gangwayais.com/v1/vessels?bbox=60.2,5.0,60.6,5.6" \ -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"
}
}
],
"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."
}
