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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
required

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

integer

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

string

A dateTime the ISO 8601 format to find the closest position

number

A timestamp to find the closest position

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json