Liveaboard Vessel Tracking API: Real-Time Maritime Data & Analytics

In the fast-paced world of maritime logistics, having access to real-time data is crucial for optimizing operations, ensuring compliance, and enhancing decision-making. The Vessels API offers a comprehensive suite of 18 REST endpoints that provide developers, startups, and enterprise teams with instant access to global maritime vessel tracking data powered by AIS (Automatic Identification System). This blog post will delve into the capabilities of the Vessels API, showcasing how it can transform your maritime operations through real-time data and analytics.

Why Choose Vessels API?

The Vessels API stands out in the maritime data landscape for several reasons:

Comprehensive coverage with 18 REST endpoints, including vessel search, live tracking, fleet operations, port intelligence, and IMO CII emissions scoring.
Single API key and base URL for seamless integration without the complexity of OAuth or per-endpoint authentication differences.
Consistent JSON envelope in every response, ensuring a uniform structure: {status, success, message, data}.
Global AIS coverage with near real-time refresh rates, providing timely and accurate data.
Scalable solutions suitable for indie developers, logistics startups, fleet managers, and port operators.
7-day free trial available for all plans, allowing users to explore the API's capabilities without commitment.

Key Features and Endpoints

The Vessels API offers a wide range of endpoints designed to meet the diverse needs of maritime professionals. Below, we will explore the most relevant endpoints for liveaboard vessel tracking, providing detailed explanations, code examples, and practical use cases.

Vessel Search

The GET /vessels/search endpoint allows users to find any vessel by name, IMO, or MMSI. This endpoint supports optional filters such as ship type, flag, and dimensions, making it a powerful tool for vessel identification.

Example Request:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=atlantic&flag=Panama"

Example Response:

{
"data": {
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Atlantic Voyager",
"flag": "Panama",
"vessel_type": "Cargo",
"gross_tonnage": 50000,
"deadweight_tonnage": 30000,
"year_built": 2010,
"length_m": 200,
"width_m": 32
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
}
}

This endpoint is essential for fleet managers and logistics teams who need to quickly locate vessels based on various criteria, enabling efficient planning and operations.

Live Vessel Tracking

The GET /vessels/track endpoint provides live position data, including up to 168 hours of position history, active routes, predicted ETAs, and weather conditions. This endpoint is crucial for real-time monitoring of vessel movements.

Example Request:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=258785000&hours=48"

Example Response:

{
"data": {
"vessel": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager"
},
"current_position": {
"latitude": 34.0522,
"longitude": -118.2437,
"speed_knots": 12,
"course_degrees": 90,
"heading_degrees": 90,
"navigational_status": "Underway",
"timestamp_utc": "2023-10-01T12:00:00Z",
"destination": "Los Angeles",
"eta": "2023-10-02T08:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "San Francisco",
"departure_time": "2023-10-01T08:00:00Z",
"destination_port": "Los Angeles",
"eta": "2023-10-02T08:00:00Z",
"distance_nm": 300,
"avg_speed_knots": 12
},
"last_port_visits": [...]
}
}

This endpoint is invaluable for logistics teams needing to track vessel movements in real-time, allowing for accurate ETAs and improved operational efficiency.

Nearby Vessels

The GET /vessels/nearby endpoint retrieves all vessels within a specified radius of a given latitude and longitude. This feature is particularly useful for port operators and logistics teams monitoring vessel traffic in specific areas.

Example Request:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/nearby?latitude=-34.60&longitude=-58.38&radius=30"

Example Response:

{
"data": {
"center": {
"latitude": -34.60,
"longitude": -58.38
},
"radius_nm": 30,
"total": 5,
"vessels": [
{
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"ship_type": "Cargo",
"position": {
"latitude": -34.60,
"longitude": -58.38,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 10,
"speed_knots": 12,
"course_degrees": 90,
"navigational_status": "Underway"
}
]
}
}

By using this endpoint, port operators can efficiently manage vessel traffic and ensure safe navigation in busy ports.

Vessel Analytics

The GET /vessels/analytics endpoint provides aggregated voyage statistics, allowing users to analyze vessel performance over specified periods. This data is crucial for fleet managers looking to optimize operations and improve efficiency.

Example Request:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/analytics?type=vessel&mmsi=258785000&period=7d"

Example Response:

{
"data": {
"type": "vessel",
"mmsi": "258785000",
"imo": "1234567",
"name": "Atlantic Voyager",
"period": "7d",
"statistics": {
"total_distance_nm": 300,
"avg_speed_knots": 12,
"max_speed_knots": 15,
"port_calls_count": 5,
"total_time_in_port_hours": 20,
"ports_visited": ["San Francisco", "Los Angeles"]
}
}
}

This endpoint enables fleet managers to make data-driven decisions, enhancing operational efficiency and reducing costs.

Fleet Operations

The POST /vessels/fleet endpoint allows users to retrieve batch positions, routes, and statistics for multiple vessels in a single request. This feature is particularly beneficial for large fleets, providing a comprehensive overview of operations.

Example Request:

curl -X POST -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"vessels":[{"imo":"9122556"},{"mmsi":"309374000"}],"include_positions":true}' "https://vessels-api.com/api/V1/vessels/fleet"

Example Response:

{
"data": {
"fleet": {
"total_vessels": 2,
"vessels_at_sea": 1,
"vessels_in_port": 1
},
"vessels": [
{
"imo": "9122556",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"position": {
"latitude": 34.0522,
"longitude": -118.2437
},
"route": {
"departure_port": "San Francisco",
"destination_port": "Los Angeles"
}
}
]
}
}

This endpoint streamlines fleet management, allowing operators to monitor multiple vessels efficiently and make informed decisions.

IMO CII Emissions Scoring

The GET /vessels/green endpoint provides IMO CII emissions scoring for ESG reporting and regulatory compliance. This feature is essential for organizations focused on sustainability and environmental responsibility.

Example Request:

curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/green?mmsi=258785000&period=30d"

Example Response:

{
"data": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"period": "30d",
"distance_nm": 300,
"estimated_emissions": {
"co2_tons": 50,
"co2_per_nm": 0.17
},
"cii": {
"score": "B",
"rating": "Good",
"year": 2023,
"regulation_reference": "IMO MEPC.339(76)"
}
}
}

This endpoint supports organizations in meeting regulatory requirements and enhancing their sustainability initiatives.

Conclusion

The Vessels API is a powerful tool for anyone involved in maritime operations, providing essential data and analytics to optimize fleet management, enhance logistics, and ensure compliance with environmental regulations. With its comprehensive suite of endpoints, real-time data capabilities, and user-friendly structure, the Vessels API is the go-to solution for developers and maritime professionals alike.

Ready to transform your maritime operations? Try Vessels API for free and discover the power of real-time maritime data and analytics today!

For more information and to get started, visit Get started with Vessels API.