Vessels
Vessels in an area
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.
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.
south*numberThe southern edge.
-90 <= value <= 90west*numberThe western edge.
-180 <= value <= 180north*numberThe northern edge.
-90 <= value <= 90east*numberThe eastern edge.
-180 <= value <= 180category?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 <= 726The ships in the box, the latest heard first.
application/json- response
results*array<>truncated*booleanWhether the box holds more than 500.
curl -X GET 'https://waykite.com/api/v1/vessels/within?south=-90&west=-180&north=-90&east=-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 } ], "truncated": false}Nearby vessels GET
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.
Get a vessel GET
Look up who a ship is by its IMO number or MMSI, as `imo:9811000` or `mmsi:235009802`: its name, call sign, type and size, as it broadcasts them, and a photo of it where one is published under a free licence. Show the photo with its `credit`, its `license` and a link to its `source`, as the licence asks. Where it is and where it is going are endpoints of their own, as they change by the hour: [position](https://waykite.com/docs/api/vessels/position) and [voyage](https://waykite.com/docs/api/vessels/voyage). When no ship is known by the number, the response is `204 No Content`, with an empty body.