AIS - Query Vessel by ID

Provides historical AIS data points for a vessel via the exactEarth HVP API.


A data block that provides historical Automatic Identification System (AIS) positions of a certain ship. These datasets are available anywhere on the globe. The datasets are available starting with 2010.

See this block on the marketplace.

This is a restricted block. To use this block, request access.

Vessel Positions
Vessel Positions

Technical information

Compatible blocks

  • Count Objects

Dataset description

These AIS points reflect the exact position of a certain vessel across time, specified by either an MMSI or EEID identifier. These points contain the corresponding static and voyage related information.

For more information, please refer to the Spire documentation.

Geographic coverage

The geographic coverage is global.

Dataset information

Data availability2010-present
File formatGeoJSON (point geometry)
Coordinate systemWGS84/EPSG4326


This data block doesn't work with a test query, only with a live job. For more information on job types, see Jobs.

This block is only allowed for internal usage of the purchasing user organization and can't be distributed externally.

The following user categories are not permitted to use this block:

  • Users based in China
  • Users based in Japan
  • Users affiliated with the US government
  • Users involved with commodity trading

AIS Historical Vessel Tracks Metadata

AIS parameterAIS parameter descriptionExample
mmsiThe Maritime Mobile Service Identity is a unique nine-digit number for identifying a ship. MMSI is programmed into all AIS systems and VHF electronics on board of the vessel and provides an internationally standardized number for contacting the vessel.263959721
imoThe International Maritime Organization is part of the static AIS information provided by the vessel's crew and can be transmitted additionally.IMO9525429
vessel_nameName of the vessel (up to 20 characters)BLACK STAR
callsignInternational radio call sign assigned to the vessel by its country of registryCRA8155
vessel_typeVessel typeCargo
vessel_type_codeThe AIS ID of the vessel type72
vessel_type_cargoDetailed description of the cargo typeCarrying DG,HS or MP,IMO hazard or Pollutant Category Y
vessel_classClass A AIS transponders are required to have a DSC (156.525 MHz) receiver, external GPS, heading, and rate of turn indicator, and can also transmit and receive safety-related text messages. Class B AIS transponders operate using Carrier-Sense TDMA (CSTDMA) broadcast mode and transmit at a power level of 2 watts.A
lengthLength approximated to the nearest meter (based on the position of the AIS Station on the vessel)99
widthWidth approximated to the nearest meter (based on the position of the AIS Station on the vessel)14
flag_countryThe vessel’s flagPortugal
flag_codeThe first 3 digits of the MMSI number indicate the vessel’s flag263
destinationThe vessel’s destination (up to 20 characters)PT FDF
etaEstimated time of arrival (UTC month/date hours: minutes)2460
draught0.1 to 25.5 metres8.6
longitudePosition coordinate (decimal degrees)-9.31821333333333
latitudePosition coordinate (decimal degrees)38.6754166666667
sogSpeed over ground (0 to 102 knots)0.1
cogCourse over ground (up to 0.1° relative to true north)85.4
rotRate of turn - right or left (0 to 720 degrees per minute)7.54420872834595
heading0 to 359 degrees79
nav_statusThe navigational status that is manually set by the vessel crewUnder Way Using Engine
nav_status_codeThe navigational status code0
sourceAIS data type (Terrestrial AIS, Satellite AIS, Vessel AIS)T-AIS
ts_pos_utcTimestamp of the last position AIS message (UTC)20211123000040
ts_static_utcTimestamp of the last static AIS message (UTC)20211122235234
dt_pos_utcDate/time of the last position AIS message (UTC)2021/11/23 0:00:40
dt_static_utcDate/time of the last static AIS message (UTC)2021/11/22 23:52:34
vessel_type_mainMain vessel typePassenger Ship
vessel_type_subSubcategory of vessel typePassenger Ro Ro Cargo Ship
message_typeAIS message type1
eeidExactEarth identifier5433869460680721844
dtgDate-time group for the last position AIS message (UTC)2021/11/23 0:00:40

How it works

Supported JSON parametersDefault valueMinMaxExamples
eeidnulln.a.n.a."eeid": ["5433869460680721844"]
mmsinulln.a.n.a."mmsi": ["211560300"]
time"2021-01-01T00:00:00+00:00/2021-01-01T23:59:59+00:00"01.07.2010present"time": "2021-11-23T00:00:00+00:00/2021-11-23T23:59:59+00:00"


Example based on a workflow created with the data block AIS Query Vessel by ID:




To know more please check the block capabilities specifications.