Vessels

Nearby vessels

GET
/api/v1/vessels/nearby

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.

Authorization

apiKey
headerAuthorizationBearer <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.

Query Parameters

lat*number

Latitude in decimal degrees.

Range-90 <= value <= 90
lon*number

Longitude in decimal degrees.

Range-180 <= value <= 180
max_distance_km?number

How far to look, in kilometres, up to 100.

Range0 < value <= 100
Default25
category?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?integer

Only ships heard from within this many hours, up to 72.

Range1 <= value <= 72
Default6
limit?integer

How many to return.

Range1 <= value <= 100
Default20

Response Body

The 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
  1. response
results*array<>
limit*integer
Example Request
curl -X GET 'https://waykite.com/api/v1/vessels/nearby?lat=-90&lon=-180'
Example Response
{
  "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
}