Getting Started

Dry Current Ship Status

The Current Ship Status API provides real-time tracking and monitoring of dry bulk vessels, offering detailed insights into their latest positions, statuses, and operational activities. It enables users to track the most recent vessel positions, ETA and destination, and monitor live maritime movements for enhanced situational awareness.

Key Features

🚢 Vessel Details – Retrieve essential vessel specifications, including IMO, name, dwt, nominal draft, type, and flag.

📍 Live Positioning Data – Access latest 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 current operational status derived from polygon events: 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.

This API provides the latest known status for the dry bulk fleet currently tracked by AXSMarine. All vessels available within the 360 Web Interface are available through this API from their first AIS ping at delivery to their last AIS ping before demolition. Users can query the complete fleet every hour, ensuring up-to-date vessel information.

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
Polygon – polygon_ids, updated_after
Status – vessel_main_statuses, is_in_blackout, destinations
Trade Flow – commodities, voyage_type, include_cabotage
Pagination – page_size (max 5,000), after (cursor)

Example Requests

Basic request:

Bash

 curl -X GET "https://apihub.axsmarine.com/dry/ship-status/current/v5?page_size=100" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Filter by main status:

Bash

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

Filter by trade flow (laden voyages):

Bash

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

Filter by vessel IMOs:

Bash

 curl -X GET "https://apihub.axsmarine.com/dry/ship-status/current/v5?page_size=100&imos=9292228,9123456" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Filter by destination:

Bash

 curl -X GET "https://apihub.axsmarine.com/dry/ship-status/current/v5?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

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

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 Current Ship Status

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

Response

Response