Latest live position (Pro and Business plans; sources: `aisstream`, `barentswatch`, `digitraffic`, `openwaters`)

404 when the vessel has no live position in your plan's live sources, with the same detail for a private or withdrawn vessel. 503 while the live view is starting.

get/v1/vessels/{mmsi}/position

Request

  • Base URL: https://api.aistrail.com
  • URL: https://api.aistrail.com/v1/vessels/{mmsi}/position
  • Auth: HTTP bearer

Path parameters

mmsiinteger required

Response

ok

mmsiinteger
tsstring date-time

Message timestamp (UTC) as reported by the source

latnumber
lonnumber
sognumber nullable

Speed over ground, knots

cognumber nullable

Course over ground, degrees

headinginteger nullable

True heading, degrees; null if unavailable (raw 511)

nav_statusinteger nullable

ITU-R M.1371 navigational status 0-14

sourcestring

Data source id, see /v1/sources

flagsstring nullable

Quality flag, e.g. implausible_jump (kept, never dropped)

imointeger nullable
namestring nullable
callsignstring nullable

Call sign; with include=static (default for csv and xlsx): the latest value the vessel reported at or before this row's time, up to 30 days back, from the sources on your plan; null when none

ship_typeinteger nullable
length_mnumber nullable
width_mnumber nullable
draught_mnumber nullable
destinationstring nullable

Destination as declared by the vessel

etastring date-time nullable

ETA as declared by the vessel

dim_ainteger nullable

AIS dimension A: GPS antenna to bow, metres; with include=static (default for csv and xlsx): the latest value the vessel reported at or before this row's time, up to 30 days back, from the sources on your plan; null when none

dim_binteger nullable

AIS dimension B: GPS antenna to stern, metres; with include=static (default for csv and xlsx): the latest value the vessel reported at or before this row's time, up to 30 days back, from the sources on your plan; null when none

dim_cinteger nullable

AIS dimension C: GPS antenna to port side, metres; with include=static (default for csv and xlsx): the latest value the vessel reported at or before this row's time, up to 30 days back, from the sources on your plan; null when none

dim_dinteger nullable

AIS dimension D: GPS antenna to starboard side, metres; with include=static (default for csv and xlsx): the latest value the vessel reported at or before this row's time, up to 30 days back, from the sources on your plan; null when none

rotnumber nullable

Rate of turn, degrees per minute

ais_classstring nullable

AIS transponder class, A or B

age_snumber

Seconds since ts

received_atstring date-time

When AIS Trail received the position

Changes

No recorded changes to this operation across all 2 revisions of this API.