Vessels
Nearby vessels
Find the ships last heard nearest a point, closest first, within 100 km. Distances are great-circle distances in kilometres, rounded to 0.1 km.
Each ship is where it was last heard: a moving ship has its position kept every half hour or so, a ship at anchor or alongside every two hours. Coverage depends on the region, so a ship out of reach is missing rather than shown where it was days ago.
apiKeyAuthorizationBearer <token>An API key from the dashboard: a secret key (wk_sk_) from servers, or a publishable key (wk_pk_) from the origins listed on it. A workload can send its token in place of a secret key. See Authentication.
lat*numberLatitude in decimal degrees.
-90 <= value <= 90lon*numberLongitude in decimal degrees.
-180 <= value <= 180max_distance_km?numberHow far to look, in kilometres, up to 100.
0 < value <= 10025category?array<>Only ships of this kind: passenger, cargo, tanker, service, fishing or other. Repeat it for several; leave it out for all of them.
heard_within_hours?integerOnly ships heard from within this many hours, up to 72.
1 <= value <= 726limit?integerHow many to return.
1 <= value <= 10020The nearest ships, closest first, each with its distance. There is no total or offset: ask for a larger limit or max_distance_km to see more.
application/json- response
results*array<>limit*integercurl -X GET 'https://waykite.com/api/v1/vessels/nearby?lat=-90&lon=-180'{
"results": [
{
"mmsi": 563254200,
"imo": 9987196,
"name": "CMA CGM SEINE",
"ship_category": "cargo",
"position": {
"at": "2026-10-26T19:41:27.369Z",
"lat": 51.903591666666664,
"lon": 3.4542516666666665,
"speed_kn": 0,
"course_deg": 276.3,
"heading_deg": 200,
"nav_status": 1
},
"state": "stopped",
"in_port": null,
"distance_km": 2.4
}
],
"limit": 1
}Search vessels GET
Find ships with an IMO number by name, IMO number, MMSI or call sign, and narrow them by flag, kind, size and the year they were built. A name matches in part, its words in any order, so `ever giv` finds EVER GIVEN; an IMO number, MMSI or call sign matches whole. The best matches come first: the query exactly, then names starting with it, then the rest, the largest ships by gross tonnage first within each. Each result is a summary of the ship's [particulars](https://waykite.com/docs/api/vessels/particulars), as recorded; fetch those for the rest, or its [position](https://waykite.com/docs/api/vessels/position) for where it is.
Vessels in an area GET
List the ships last heard in a box, by its edges in decimal degrees, the latest heard first: every ship a map shows, for example. A box may be up to 5 degrees a side, and one whose west edge is east of its east edge crosses the antimeridian. At most 500 ships are returned; `truncated` says when there were more, and a smaller box or fewer kinds of ship shows them all. Each ship is where it was last heard: a moving ship has its position kept every half hour or so, a ship at anchor or alongside every two hours. Coverage depends on the region, so a ship out of reach is missing rather than shown where it was days ago.