Liner Historical Ship Status
The Historical Ship Status API provides point-in-time snapshots of all containers and passenger 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.
📌 Service Identification – Each status includes vessel_service_name and vessel_service_id, representing the service the vessel is part of. This enables deeper segmentation of vessel activity based on service context.
🗺 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. Results are limited to 10,000 statuses per page. For handling large datasets, refer to the pagination section.
🚀 This API supports data-driven decision-making for logistics, shipping operations, and supply chain management by providing high-fidelity maritime data.
This API has been designed for simplified use and easy integration. It provides a flat response format that can be easily used as a single-dimensional table.
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.
Query Parameters
Maximum number of results per page.
Example 10
List of polygon Ids as array. Can be used either as an integer, separated by commas, or by repeating the parameter.
Examples
- commaSeparated:
19896,9242 - parameterRepeated:
polygon_ids=19896&polygon_ids=9242
List of vessel unique IDs as array. Can be used either as a string, separated by commas, or by repeating the parameter. Examples
- commaSeparated:
108728,4105 - parameterRepeated:
vessel_ids=108728&vessel_ids=4105
List of vessel IMOs as array. Can be used either as a string, separated by commas, or by repeating the parameter. Examples
- commaSeparated:
9388534,44153 - parameterRepeated:
imos=9388534&imos=44153
Vessel built from.
Recognized date format is YYYY-MM-DD
Example 2005-01-01
Vessel built to.
Recognized date format is YYYY-MM-DD
Example 2006-01-01
Vessel beam from.
Example 45
Vessel beam to.
Example 55
Vessel loa from.
Example 200
Vessel loa to.
Example 300
Vessel draft from.
Example 10
Vessel draft to.
Example 20
Vessel dwt from.
Example 200000
Vessel dwt to.
Example 300000
Vessel TEU from.
Example 2000
Vessel TEU to.
Example 20000
List of vessel service ids as array. Can be used either as a string, separated by commas, or by repeating the parameter. Examples
- commaSeparated:
666,291 - parameterRepeated:
vessel_service_ids=666&vessel_service_ids=291
List of service region ids as array. Can be used either as a string, separated by commas, or by repeating the parameter.
Examples
- commaSeparated:
35,68 - parameterRepeated:
vessel_service_region_ids=35&vessel_service_region_ids=68
Ais date from. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.
Example 2024-01-01T00:00:00
Ais date to. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.
Example 2025-04-01T00:00:00
Ais heading from.
Example 0
Ais heading to.
Example 180
Ais draft from.
Example 5
Ais draft to.
Example 15
Ais speed from.
Example 5
Ais speed to.
Example 15
List of snapshot hours. Can be used either as an integer, separated by commas, or by repeating the parameter. Only 0,6,12,18 values are allowed.
Examples
- commaSeparated:
0,12 - parameterRepeated:
snapshot_hours=0&snapshot_hours=12
Beginning of the time of the snapshot. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.
Example 2024-12-24T15:00:00
End of the time of the snapshot. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.
Example 2024-12-27T15:00:00
Polygon event updated after. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.
Example 2025-01-01T00:00:00
Response
Response Attributes
Show child attributes
Object containing useful links for the API.