Historical Ship Status
The Historical Ship Status API provides point-in-time snapshots of all vessels being monitored or previously monitored by AXSMarine, offering detailed insights into their historical positions, statuses, and operational activities.
For ease of use, these snapshots are available at regular intervals: 00:00, 06:00, 12:00 and 18:00 hours. Even in the event of a temporary loss of visibility (black-out), snapshots remain accessible and display the current status of the vessel as well as the last known information prior to the onset of black-out conditions.
Key Features
🚢 Vessel Details – Retrieve essential vessel specifications, including IMO, name, dwt, nominal draft, type, and flag.
📍 Positioning Data – Access cleaned AIS signals with latitude, longitude, speed, heading, draft, and navigation status.
🗺 Geospatial Insights – Identify vessel presence in specific zones such as ports, canals, berths, anchorages, and shipyards using AXSMarine proprietary polygon-based tracking.
⏳ Destination & ETA – Monitor reported destination and estimated time of arrival.
⚠️ Blackout Events – Detect AIS signal loss or transmission gaps to assess operational reliability and identify potential dark activities, such as intentional tracking disablement.
📊 Pagination & Query Control – Handle large datasets efficiently with cursor-based pagination for structured data retrieval.
🚀 This API supports data-driven decision-making for logistics, shipping operations, and supply chain management by providing high-fidelity maritime data.
The purpose of this API is to provide a unified response across all vertical markets that we serve. Two points need to be taken into considerations:
- Geographic location: While most geographic locations are common across all verticals (e.g. the Port of Rotterdam is identical for dry and tanker vessels), this is not the case for zone locations, which are market-dependent areas and are not shared across verticals.
- Segments filtering: This API offers greater granularity than REST APIs, which are decoupled by main verticals (dry / tanker). In contrast, this API provides a more detailed list of segments, as shown below:
| |
| |
|
In this historical API, Snapshots are available for all vessels from the first AIS signal up to the vessel demolition date.
Header Parameters
Bearer token used for authentication.
Body Parameters
Returns the first n elements from the list.
Returns the elements in the list that come before the specified cursor.
Returns the elements in the list that come after the specified cursor.
Time of the snapshot. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.
Show child attributes
List of snapshot hours. Available values:
- 0
- 6
- 12
- 18
Range of time of the latest AIS signal reception. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.
Show child attributes
Range of headings of the vessel in degrees.
Show child attributes
Range of speeds of the vessel in knots
Show child attributes
Range of drafts of the vessel in meters.
Show child attributes
Last update of the status. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.
Show child attributes
Range of dates during which the vessel was built. Date in YYYY-MM-DD format.
Show child attributes
Range of beam of the vessel (in meters).
Show child attributes
Range of length overall of the vessel (in meters).
Show child attributes
Range of nominal draft of the vessel (in meters).
Show child attributes
Range of deadweight tonnage of the vessel.
Show child attributes
Range of TEU of the vessel.
Show child attributes
Range of cubic capacity of the vessel.
Show child attributes
List of vessel IMOs.
List of vessel segments. Refer to Enum Vessel Segments for more details.
List of vessel types. Refer to Enum Vessel Types for more details.
List of vessel subtypes.
List of vessel service ids.
List of service region ids.
List of polygon Ids.