Getting Started

Dry Voyages

The Dry Voyages API provides comprehensive tracking and analysis of vessel voyages for the DRY market segment (dry bulk, MPP, and OBO vessels). This REST API enables users to query a paginated list of voyages with a rich set of filters, offering a simpler alternative to the GraphQL endpoint while maintaining powerful filtering capabilities.

A voyage represents a complete journey undertaken by a vessel, including loading and discharge operations, port calls, and associated commodities. Each voyage contains detailed information about the vessel, its route, operational metrics, and cargo details.

Key Features

🆔 Consistent Voyage Identifier – Every voyage now includes a persistent and unique id field, allowing you to reliably track voyage updates over time. This means you no longer need to pull the entire dataset each time you want to analyze or sync voyage data.

🚢 Comprehensive Voyage Data – Access detailed voyage information including vessel specifications, commodities, port calls, and operational metrics such as speed, duration, and draft measurements.

📍 Port Call Tracking – Track loading and discharge operations with detailed location information including zones, ports, berths, and anchorage data.

📦 Commodity Management – Retrieve comprehensive commodity information including intake volumes (metric tonnes, cubic metres, barrels), boil-off volumes, and charterer details.

⏱ Operational Metrics – Analyze voyage performance with metrics such as average speed, top speed, duration, sea duration, and draft ratios.

🎯 Flexible Filtering – Apply filters by:

Voyage type (laden, ballast)
Current voyages only
Cabotage exclusion
Commodities (names, IDs, or groups)
Date ranges (start, end, last updated)
Load and discharge areas (IDs, names, UNLOCODEs)
Vessel specifications (IMO, DWT, LOA, beam, draft, TEU)
Vessel segments (dry, mpp, obo), types, and sub-types
Predicted voyages inclusion
Ship-to-ship operations (load/discharge STS)

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

🔮 Predicted Voyages – Include predicted voyages in your queries to track future vessel movements and planned operations.

This REST endpoint offers a simpler way to get voyage data compared to the GraphQL endpoint. It is perfect for customers who value ease of use over advanced querying capabilities. The API automatically filters results to the DRY market segment (dry, mpp, obo).

Example Requests

Basic Request

CURL

curl -X GET "https://apihub.axsmarine.com/dry/voyage/v4?page_size=10" -H "Authorization: Bearer YOUR_API_TOKEN"

Current Voyages Only

CURL

curl -X GET "https://apihub.axsmarine.com/dry/voyage/v4?page_size=50&only_current=true" -H "Authorization: Bearer YOUR_API_TOKEN"

Filter by Vessel Specifications and Date Range

CURL

curl -X GET "https://apihub.axsmarine.com/dry/voyage/v4?page_size=50&vessel_dwt_from=50000&vessel_dwt_to=100000&vessel_segments=dry&start_from=2025-01-01&start_to=2025-12-31" -H "Authorization: Bearer YOUR_API_TOKEN"

Filter by Commodities and Load Areas

CURL

curl -X GET "https://apihub.axsmarine.com/dry/voyage/v4?page_size=50&commodities=Iron%20Ore,Coal&load_areas=North%20West%20Africa&exclude_cabotage=true" -H "Authorization: Bearer YOUR_API_TOKEN"

Include Predicted Voyages

CURL

curl -X GET "https://apihub.axsmarine.com/dry/voyage/v4?page_size=50&include_predicted=true&only_current=true" -H "Authorization: Bearer YOUR_API_TOKEN"

Filter by Multiple Vessel IMOs

CURL

curl -X GET "https://apihub.axsmarine.com/dry/voyage/v4?page_size=100&vessel_imos=9281906,9123456" -H "Authorization: Bearer YOUR_API_TOKEN"

Market Segment

This API automatically filters results to the DRY market segment, which includes:

dry – Dry bulk carriers
mpp – Multi-purpose vessels
obo – Oil/Bulk/Ore carriers

This API handles large datasets. Results are limited to 10,000 voyages per page. Use pagination to retrieve all results efficiently.

Header Parameters

Authorizationstring Required

Bearer token used for authentication.

Query Parameters

page_sizeinteger

Maximum number of results per page.

Example 10

Maximum

10000

typestring

Filter by the type of voyage.

Example laden

Enum values:

ballastladen

only_currentboolean

Include only voyages that are still in progress.

Example true

exclude_cabotageboolean

Exclude voyages that are classified as cabotage.

Example true

include_predictedboolean

Include voyages that are predicted.

Example true

start_fromstring

Filter voyages that started on or after this date (YYYY-MM-DD).

start_tostring

Filter voyages that started on or before this date (YYYY-MM-DD).

end_fromstring

Filter voyages that finished on or after this date (YYYY-MM-DD).

Example 2025-01-01

end_tostring

Filter voyages that finished on or before this date (YYYY-MM-DD).

Example 2025-12-31

load_stsboolean

Include only voyages that have a loaded status (ship-to-ship).

disch_stsboolean

Include only voyages that have a discharged status (ship-to-ship).

load_areasarray

Filter by the IDs, names, or UNLOCODEs of the load areas. Supports comma-separated values.

disch_areasarray

Filter by the IDs, names, or UNLOCODEs of the discharge areas. Supports comma-separated values.

updated_afterstring

Filter by the last updated date/time. Date-time in ISO 8601 format (YYYY-MM-DDTHH:mm:ss) and UTC.

Example 2025-06-01T00:00:00

vessel_built_fromstring

Filter by the year the vessel was built (from, inclusive).

Recognized date format is YYYY-MM-DD

Example 2005-01-01

vessel_built_tostring

Filter by the year the vessel was built (to, inclusive).

Recognized date format is YYYY-MM-DD

Example 2005-01-01

vessel_beam_fromnumber

Filter by the minimum beam of the vessel (metres).

Example 30.0

vessel_beam_tonumber

Filter by the maximum beam of the vessel (metres).

Example 60.0

vessel_loa_fromnumber

Filter by the minimum length overall (LOA) of the vessel (metres).

Example 200.0

vessel_loa_tonumber

Filter by the maximum length overall (LOA) of the vessel (metres).

Example 400.0

vessel_draft_fromnumber

Filter by the minimum draft of the vessel (metres).

Example 10.0

vessel_draft_tonumber

Filter by the maximum draft of the vessel (metres).

Example 25.0

vessel_dwt_frominteger

Filter by the minimum deadweight tonnage of the vessel.

Example 50000

vessel_dwt_tointeger

Filter by the maximum deadweight tonnage of the vessel.

Example 320000

vessel_teu_frominteger

Filter by the minimum TEU capacity of the vessel.

Example 1000

vessel_teu_tointeger

Filter by the maximum TEU capacity of the vessel.

Example 24000

vessel_idsarray

Filter by the vessel IDs. Supports comma-separated values.

Example 12345,67890

vessel_imosarray

Filter by the IMO numbers of the vessels. Supports comma-separated values.

Example 9123456,9234567

vessel_segmentsarray

Filter by the vessel segments (e.g. 'dry', 'mpp', 'obo'). Supports comma-separated values.

Example dry,mpp,obo

vessel_typesarray

Filter by the vessel types (e.g. 'Bulk carrier', 'General Cargo Ship'). Supports comma-separated values.

Example Bulk carrier,General Cargo Ship

vessel_subtypesarray

Filter by the vessel sub-types (e.g. 'VLCC', 'Suezmax'). Supports comma-separated values.

Example VLCC,Suezmax

commoditiesarray

Filter by commodity names, IDs or groups. Supports comma-separated values.

Example Iron Ore,Coal

Response

200

Object

Successful response with list of voyages.

Response Attributes

resultsarray

List of voyage objects.

Show child attributes

linksobject

Object containing useful links for the API.

Show child attributes

Sections

Dry Voyages

Key Features

Example Requests

Basic Request

Current Voyages Only

Filter by Vessel Specifications and Date Range

Filter by Commodities and Load Areas

Include Predicted Voyages

Filter by Multiple Vessel IMOs

Market Segment

Header Parameters

Query Parameters

ResponseExpand all

Response Attributes

Response

Response