Vessels

Vessel positions

GET
/api/v1/vessels/positions

Where several ships were last heard, and the ports they are in: up to 100 at once, each by its IMO number or MMSI, e.g. to show a fleet on a map. Each position is as position gives it, in the order asked; a ship with no known position is left out.

The call counts as a request for each ship asked about.

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

id*array<|>

A ship, as imo: and its IMO number or mmsi: and its MMSI. Repeat it for each ship, up to 100: id=imo:9811000&id=mmsi:235009802.

Response Body

Where the ships were last heard.

application/json
  1. response
results*array<>
Example Request
curl -X GET 'https://waykite.com/api/v1/vessels/positions?id=string'
Example Response
{
  "results": [
    {
      "mmsi": 563254200,
      "imo": 9987196,
      "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,
      "in_port": null
    }
  ]
}