Introduction
In the fast-paced world of maritime logistics, having access to real-time data is crucial for effective decision-making. Whether you are a fleet manager, a logistics startup, or part of an ESG compliance team, the ability to track vessels, analyze their performance, and understand port conditions can significantly enhance operational efficiency. This is where Vessels API comes into play, offering a comprehensive REST API with 17 endpoints designed to provide developers and businesses with instant access to global maritime vessel tracking data powered by AIS (Automatic Identification System).
Why Choose Vessels API?
Vessels API stands out in the maritime data landscape for several reasons:
- 18 REST endpoints covering vessel search, live tracking, fleet operations, port intelligence, and IMO CII emissions scoring.
- One API key and one base URL, eliminating the complexity of OAuth and per-endpoint authentication differences.
- A consistent JSON envelope on every response, ensuring ease of integration:
{status, success, message, data}. - Global AIS coverage with near real-time refresh rates, providing timely and accurate data.
- A 7-day free trial on all plans, allowing users to explore the API's capabilities before committing.
- Scalable solutions that cater to indie developers, startups, and enterprise fleets alike.
In this blog post, we will delve into the various endpoints offered by Vessels API, focusing on their capabilities, practical use cases, and how they can solve common challenges faced in maritime operations.
Vessel Intelligence Endpoints
The Vessel Intelligence endpoints are designed to provide detailed information about individual vessels, including their current positions, historical data, and analytics. Here are the key endpoints:
1. Vessel Search
The /vessels/search endpoint allows you to find any vessel by name, IMO, or MMSI. You can also apply optional filters such as ship type, flag, and more.
cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=atlantic&flag=Panama"Response Example:
{
"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": 30
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
}
}This endpoint is invaluable for fleet managers who need to quickly locate vessels within their fleet or for logistics companies looking to track specific ships.
2. Live Vessel Tracking
The /vessels/track endpoint provides live position data along with up to 168 hours of position history, active routes, predicted ETAs, and weather conditions.
cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=258785000&hours=48"Response Example:
{
"data": {
"vessel": {
"imo": "2587850",
"mmsi": "258785000",
"name": "Nordic Star"
},
"current_position": {
"latitude": 34.56,
"longitude": -58.38,
"speed_knots": 12,
"course_degrees": 90,
"heading_degrees": 90,
"navigational_status": "Underway",
"timestamp_utc": "2023-10-01T12:00:00Z",
"destination": "Port of Call",
"eta": "2023-10-02T12:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "Port A",
"departure_time": "2023-10-01T10:00:00Z",
"destination_port": "Port B",
"eta": "2023-10-02T12:00:00Z",
"distance_nm": 150,
"avg_speed_knots": 12
},
"last_port_visits": [...]
}
}This endpoint is essential for logistics teams needing to provide accurate ETAs to clients and for fleet managers monitoring vessel movements in real-time.
3. Nearby Vessels
The /vessels/nearby endpoint retrieves all vessels within a specified radius of a given latitude and longitude.
cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/nearby?latitude=-34.60&longitude=-58.38&radius=30"Response Example:
{
"data": {
"center": {
"latitude": -34.60,
"longitude": -58.38
},
"radius_nm": 30,
"total": 5,
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"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"
}
]
}
}This endpoint is particularly useful for port operators and logistics teams who need to monitor vessel traffic in specific areas.
4. Vessel Analytics
The /vessels/analytics endpoint provides aggregated voyage statistics, allowing users to switch modes between vessel, port, or fleet analytics.
cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/analytics?type=vessel&mmsi=258785000&period=7d"Response Example:
{
"data": {
"type": "vessel",
"mmsi": "258785000",
"imo": "2587850",
"name": "Nordic Star",
"period": "7d",
"statistics": {
"total_distance_nm": 300,
"avg_speed_knots": 10,
"max_speed_knots": 15,
"port_calls_count": 5,
"total_time_in_port_hours": 20,
"ports_visited": ["Port A", "Port B"]
}
}
}This endpoint is invaluable for fleet managers looking to analyze vessel performance over time, helping them make data-driven decisions.
Fleet Operations Endpoints
The Fleet Operations endpoints allow users to manage multiple vessels simultaneously, providing batch data for enhanced operational efficiency.
5. Fleet Management
The /vessels/fleet endpoint enables users to retrieve batch positions, routes, and statistics for multiple vessels in a single request.
cURL Example:
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"Response Example:
{
"data": {
"fleet": {
"total_vessels": 2,
"vessels_at_sea": 1,
"vessels_in_port": 1
},
"vessels": [
{
"imo": "9122556",
"mmsi": "309374000",
"name": "Vessel A",
"position": {
"latitude": -34.60,
"longitude": -58.38
},
"route": {
"departure_port": "Port A",
"destination_port": "Port B"
}
}
]
}
}This endpoint is crucial for fleet managers who need to monitor the status of multiple vessels at once, streamlining operations and improving response times.
Port Intelligence Endpoints
Understanding port conditions is vital for effective maritime operations. The Port Intelligence endpoints provide insights into port congestion, expected arrivals, and more.
6. Port Congestion
The /ports/congestion endpoint offers real-time congestion snapshots and wait-time statistics for a specified port.
cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports/congestion?port_id=ARBUE&period=7d"Response Example:
{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"period": "7d",
"snapshot": {
"vessels_in_anchorage": 5,
"vessels_at_berth": 3
},
"statistics": {
"avg_wait_time_hours_last_7d": 2,
"max_wait_time_hours_last_7d": 5,
"avg_berth_time_hours_last_7d": 3,
"port_calls_count": 20
}
}
}This endpoint is essential for logistics teams needing to plan arrivals and departures based on current port conditions.
7. Expected Arrivals
The /port/expected-arrivals endpoint provides a list of vessels expected to arrive at a specified port, including their ETA and origin.
cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/expected-arrivals?port=ARBUE"Response Example:
{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"expected_arrivals": [
{
"mmsi": "123456789",
"imo": "1234567",
"name": "Atlantic Voyager",
"vessel_type": "Cargo",
"eta": "2023-10-02T12:00:00Z",
"departure_port": "Port A"
}
],
"total": 1
}
}This endpoint is particularly useful for port operators and logistics teams to manage incoming traffic effectively.
Environmental Compliance with IMO CII Scoring
With increasing regulatory scrutiny on emissions, the /vessels/green endpoint provides IMO CII emissions scoring for ESG reporting and regulatory compliance.
cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/green?mmsi=258785000&period=30d"Response Example:
{
"data": {
"imo": "2587850",
"mmsi": "258785000",
"name": "Nordic Star",
"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 is crucial for companies looking to enhance their sustainability efforts and comply with environmental regulations.
Conclusion
In an industry where timely and accurate data can make or break operations, Vessels API provides a robust solution for accessing maritime data. With its comprehensive suite of endpoints, developers and businesses can easily integrate vessel tracking, analytics, and port intelligence into their applications. Whether you are managing a fleet, optimizing logistics, or ensuring compliance with environmental regulations, Vessels API is your go-to resource for maritime data.
Don't miss out on the opportunity to enhance your maritime operations. Try Vessels API for free and discover how it can transform your business today!
Ready to get started? Get started with Vessels API and unlock the potential of real-time maritime data.
