Getting Started

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

Authorizationstring Required

Bearer token used for authentication.

Query Parameters

page_sizeinteger

Maximum number of results per page.

Example 10

Maximum

10000

polygon_idsstring

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

vessel_idsstring

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

imosstring

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_fromstring

Vessel built from.

Recognized date format is YYYY-MM-DD

Example 2005-01-01

vessel_built_tostring

Vessel built to.

Recognized date format is YYYY-MM-DD

Example 2006-01-01

vessel_beam_fromnumber

Vessel beam from.

Example 45

vessel_beam_tonumber

Vessel beam to.

Example 55

vessel_loa_fromnumber

Vessel loa from.

Example 200

vessel_loa_tonumber

Vessel loa to.

Example 300

vessel_draft_fromnumber

Vessel draft from.

Example 10

vessel_draft_tonumber

Vessel draft to.

Example 20

vessel_dwt_frominteger

Vessel dwt from.

Example 200000

vessel_dwt_tointeger

Vessel dwt to.

Example 300000

vessel_teu_frominteger

Vessel TEU from.

Example 2000

vessel_teu_tointeger

Vessel TEU to.

Example 20000

vessel_service_idsstring

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

vessel_service_region_idsstring

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_fromstring

Ais date from. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.

Example 2024-01-01T00:00:00

ais_date_tostring

Ais date to. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.

Example 2025-04-01T00:00:00

ais_heading_frominteger

Ais heading from.

Example 0

ais_heading_tointeger

Ais heading to.

Example 180

ais_draft_fromnumber

Ais draft from.

Example 5

ais_draft_tonumber

Ais draft to.

Example 15

ais_speed_fromnumber

Ais speed from.

Example 5

ais_speed_tonumber

Ais speed to.

Example 15

snapshot_hoursstring

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

snapshot_time_fromstring

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

snapshot_time_tostring

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

updated_afterstring

Polygon event updated after. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.

Example 2025-01-01T00:00:00

Response

200

Object

Response Attributes

resultsarray

Show child attributes

linksobject

Object containing useful links for the API.

Show child attributes

Sections

Liner Historical Ship Status

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

Response

Response