---
title: "Get vessel position"
method: GET
path: "/vessel/v2/position"
tags: ["Position"]
---

# Get vessel position

`GET /vessel/v2/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.

## Query parameters

- `imo` integer, required
- `mmsi` integer
- `dateTime` string
- `timestamp` number

## Response `200`

OK

## Other responses

- `400` — Bad request
- `503` — Service unavailable.

---

[API](https://skmtc.dev/searoutes/apis/geocoding.md) · [All operations](https://skmtc.dev/searoutes/apis/geocoding/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/searoutes/geocoding/revisions/59f769fc4f39/schema)