v1

latestOpenAPI 3.1.02026-07-243613262.4 KB
Position

Get vessel position

Retrieve information from static and dynamic AIS messages for a vessel. Vessel are identified either by imo or mmsi. You can pass a dateTime or timestamp as parameter to get the closest position to a specific time. This endpoint returns the position as geoJSON, along with properties such as speed over ground (in km/h), course over ground, heading, current draft (in m), the navigational status reported over AIS (navigationalStatus, with the AIS status code and its label), the origin port call (originPort, the last port the vessel departed from, with arrival/departure times and duration of the call in hours), the raw AIS destination (destination) together with the resolved destination port (destinationPort), and the estimated time of arrival to the next port (eta).

The position time is returned both as a human readable dateTime (ISO 8601) and as an epoch timestamp (in ms).

Note: originPort is only returned when a recent enough port call can be resolved for the vessel; otherwise it is omitted.

get/vessel/v2/position

Query parameters

imointeger required
Example:9299628

imo number of the vessel (required if mmsi is not used)

mmsiinteger
Example:220061000

mmsi number of the vessel (required if imo not used)

dateTimestring
Example:2024-08-01T00:00:00Z

A dateTime the ISO 8601 format to find the closest position

timestampnumber
Example:1690851066000

A timestamp to find the closest position

Response

OK