Getting Started

Sections

Theme switcher

Current Ship Status

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

📊 Pagination & Query Control – Handle large datasets efficiently with cursor-based pagination for structured data retrieval.

🚀 This API supports data-driven decision-making for logistics, shipping operations, and supply chain management by providing high-fidelity maritime data.

The GraphQL endpoint provides enhanced filtering capabilities and returns a richer dataset compared to its RESTful counterparts, albeit with an increase in complexity. Below, we provide illustrative examples to facilitate your utilization of this API.

Our REST endpoint Dry or Tanker or Liner offers a simpler way to get what you need. It is perfect for customers who value ease of use over advanced querying capabilities.

The purpose of this API is to provide a unified response across all vertical markets that we serve. Two points need to be taken into considerations:

  • Geographic location: While most geographic locations are common across all verticals (e.g. the Port of Rotterdam is identical for dry and tanker vessels), this is not the case for zone locations, which are market-dependent areas and are not shared across verticals.
  • Segments filtering: This API offers greater granularity than REST APIs, which are decoupled by main verticals (dry / tanker). In contrast, this API provides a more detailed list of segments, as shown below:
REST Endpoint equivalent
Segments

Dry Ship Status

["dry", "mpp", "obo"]

Tanker Ship Status

["tanker", "chemoil", "chemical", "lpg", "lng", "fso", "obo"]

Liner Ship Status

["liner", “mpp”, "ropax_ferry", "pctc", “passenger”, "roro", "reefer", "conro", "rolo"]

This API provides the latest known status for the entire active 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.

This API is handling large datasets. Please refer to the Pagination documentation for more information. Results are limited to 10,000 vessels per page.

Header Parameters

Authorizationstring Required

Bearer token used for authentication.

Body Parameters

firstint

Returns the first n elements from the list.

beforestring

Returns the elements in the list that come before the specified cursor.

afterstring

Returns the elements in the list that come after the specified cursor.

lastUpdatedobject

Last update of the status. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.

Show child attributes

aisDateobject

Range of time of the latest AIS signal reception. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.

Show child attributes

aisHeadingobject

Range of headings of the vessel in degrees.

Show child attributes

aisSpeedobject

Range of speeds of the vessel in knots

Show child attributes

aisDraftobject

Range of drafts of the vessel in meters.

Show child attributes

vesselBuiltobject

Range of dates during which the vessel was built. Date in YYYY-MM-DD format.

Show child attributes

vesselBeamobject

Range of beam of the vessel (in meters).

Show child attributes

vesselLoaobject

Range of length overall of the vessel (in meters).

Show child attributes

vesselDraftobject

Range of nominal draft of the vessel (in meters).

Show child attributes

vesselDwtobject

Range of deadweight tonnage of the vessel.

Show child attributes

vesselTeuobject

Range of TEU of the vessel.

Show child attributes

vesselCubicobject

Range of cubic capacity of the vessel.

Show child attributes

vesselIdsarray
vesselImosarray

List of vessel IMOs.

vesselSegmentsarray

List of vessel segments. Refer to Enum Vessel Segments for more details.

vesselTypesarray

List of vessel types. Refer to Enum Vessel Types for more details.

vesselSubtypesarray

List of vessel subtypes.

vesselLinerServiceIdsarray

List of vessel service ids.

vesselLinerRegionIdsarray

List of service region ids.

polygonIdsarray

List of polygon Ids.

POST

/

Select
1

Response