Getting Started

Sections

Theme switcher

Liner Current Ship Status

The Current Ship Status API provides real-time tracking and monitoring of containers and passenger 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.

📌 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 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.

Want more control over your data? Our GraphQL API offers advanced querying capabilities, allowing users to retrieve exactly the information they need. Unlike this REST API, which is dedicated to dry bulk vessels, the GraphQL API provides real-time data across all vessel segments, including tankers, gas carriers, liners, and more. Users can customize queries to select specific fields, ensuring efficient data retrieval tailored to their operational needs.

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.

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 2025-04-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-10T00: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-06-01T00:00:00

Response

200
Object
OK

Response Attributes

resultsarray

Show child attributes

linksobject

Object containing useful links for the API.

Show child attributes

GET

/

Select
1

Response