Getting Started

Dry Historical Ship Status

The Historical Ship Status API provides point-in-time snapshots of all dry bulk 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.

🏷 Main Status – Get the vessel's operational status at the time of the snapshot: at_shipyard, at_berth, at_anchorage, at_canal, at_port, or at_sea. Filter vessels by one or more statuses using the vessel_main_statuses parameter.

🚢 Trade Flow – Access voyage-level trade flow information including voyage type (laden / ballast), cabotage flag, commodity details (name, group, intake in MT and CBM), and departure/arrival locations (port, country, zone) with date ranges.

📊 Pagination & Query Control – Handle large datasets efficiently with cursor-based pagination for structured data retrieval. Results are limited to 5,000 vessels 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.

Filtering

🎯 Apply filters by:

Vessel – imos, vessel_ids, vessel_dwt_from / vessel_dwt_to, vessel_built_from / vessel_built_to, vessel_beam_from / vessel_beam_to, vessel_loa_from / vessel_loa_to, vessel_draft_from / vessel_draft_to, vessel_teu_from / vessel_teu_to
AIS – ais_date_from / ais_date_to, ais_heading_from / ais_heading_to, ais_draft_from / ais_draft_to, ais_speed_from / ais_speed_to
Snapshot – snapshot_hours (only 0,6,12,18), snapshot_time_from / snapshot_time_to
Polygon – polygon_ids, updated_after
Status – vessel_main_statuses, is_in_blackout, destinations
Trade Flow – commodities, voyage_type, include_cabotage
Pagination – page_size (max 10,000), after (cursor)

Example Requests

Basic request:

Bash

 curl -X GET "https://apihub.axsmarine.com/dry/ship-status/historical/v6?page_size=100&snapshot_hours=0" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Filter by main status:

Bash

 curl -X GET "https://apihub.axsmarine.com/dry/ship-status/historical/v6?page_size=100&vessel_main_statuses=at_berth,at_anchorage&snapshot_hours=0,12" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Filter by trade flow (laden voyages):

Bash

 curl -X GET "https://apihub.axsmarine.com/dry/ship-status/historical/v6?page_size=100&voyage_type=laden&commodities=Coal" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Filter by vessel IMOs and date range:

Bash

 curl -X GET "https://apihub.axsmarine.com/dry/ship-status/historical/v6?page_size=100&imos=9292228,9123456&snapshot_time_from=2025-01-01T00:00:00Z&snapshot_time_to=2025-06-01T00:00:00Z" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Filter by destination:

Bash

 curl -X GET "https://apihub.axsmarine.com/dry/ship-status/historical/v6?page_size=100&destinations=Singapore" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Header Parameters

Authorizationstring Required

Bearer token used for authentication.

Query Parameters

page_sizeinteger

Maximum number of results per page.

Example 10

Maximum

10000

afterstring

Cursor of the last event. Will return events after this one based on filters.

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: 50881,98331
parameterRepeated: vessel_ids=50881&vessel_ids=98331

imosstring

List of vessel IMOs as array. Can be used either as a string, separated by commas, or by repeating the parameter. Examples

commaSeparated: 8419520,9281906
parameterRepeated: imos=8419520&imos=9281906

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

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

vessel_main_statusesstring

List of vessel main statuses. Can be used either as a string separated by commas, or by repeating the parameter.

Available values: at_shipyard, at_berth, at_anchorage, at_canal, at_port, at_sea

Examples

commaSeparated: at_berth,at_anchorage
parameterRepeated: vessel_main_statuses=at_berth&vessel_main_statuses=at_anchorage

include_cabotageboolean

Include vessels in cabotage voyages.

Example true

commoditiesstring

List of commodities. Can be used either as a string separated by commas, or by repeating the parameter.

Examples

commaSeparated: Iron Ore,Coal
parameterRepeated: commodities=Iron Ore&commodities=Coal

voyage_typestring

Filter by voyage type.

Example laden

Enum values:

ladenballast

is_in_blackoutboolean

Filter by blackout status. Set to true to only return vessels currently in blackout, false to exclude them.

Example true

destinationsstring

Filter by destination port/country. Accepts location IDs (numeric strings), location names or location UN/LOCODE. Multiple values use OR logic.

Examples

commaSeparated: Singapore,Shanghai
parameterRepeated: destinations=Singapore&destinations=Shanghai

Response

200

Object

Response Attributes

resultsarray

Show child attributes

All Of:

nextstring

Only available if there are more items than the requested page_size for the same parameters. This is a link to the next page of the request, using the same parameters.

Sections

Dry Historical Ship Status

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

Response

Response