In the fast-paced world of maritime logistics, having access to real-time vessel tracking data is crucial for optimizing operations, ensuring compliance, and enhancing decision-making. The Vessels API provides developers, startups, and enterprise teams with a powerful REST API that offers comprehensive maritime data solutions. With 17 endpoints covering vessel search, live AIS tracking, fleet operations, port intelligence, and IMO CII emissions scoring, the Vessels API is designed to meet the diverse needs of the maritime industry.
Why Choose Vessels API?
The Vessels API stands out in the maritime data landscape for several reasons:
- 18 REST endpoints that cover a wide range of functionalities, including vessel search, live tracking, fleet operations, port intelligence, and emissions scoring.
- One API key and a single base URL simplify the authentication process, eliminating the need for OAuth or per-endpoint authentication differences.
- Consistent JSON envelope on every response, ensuring a uniform structure:
{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.
- Target users include developers, logistics startups, fleet managers, port operators, and ESG/compliance teams.
Key Features and Endpoints
The Vessels API offers a rich set of endpoints that cater to various maritime data needs. Below, we will explore the most relevant endpoints for motor vessel tracking, providing detailed explanations, code examples, and practical use cases.
Vessel Intelligence
1. Search for Vessels
The GET /vessels/search endpoint allows users to find any vessel by name, IMO, or MMSI. Optional filters such as ship type, flag, and year built can refine the search.
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": 32
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
}
}This endpoint is essential for logistics teams needing to quickly locate vessels for operational planning and tracking.
2. 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.
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": "Vessel Name",
"current_position": {
"latitude": 34.56,
"longitude": -120.45,
"speed_knots": 12,
"course_degrees": 90,
"heading_degrees": 90,
"navigational_status": "Underway",
"timestamp_utc": "2023-10-01T12:00:00Z",
"destination": "Port of Los Angeles",
"eta": "2023-10-02T15:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "Port of San Francisco",
"departure_time": "2023-10-01T08:00:00Z",
"destination_port": "Port of Los Angeles",
"eta": "2023-10-02T15:00:00Z",
"distance_nm": 200,
"avg_speed_knots": 12
},
"last_port_visits": [...]
}
}
}This endpoint is invaluable for fleet managers who need to monitor vessel movements in real-time, ensuring timely arrivals and optimizing logistics operations.
3. Nearby Vessels
The GET /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": "Nearby Vessel",
"ship_type": "Cargo",
"position": {
"latitude": -34.61,
"longitude": -58.39,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 1.5,
"speed_knots": 10,
"course_degrees": 180,
"navigational_status": "At Anchor"
}
]
}
}This endpoint is particularly useful for port operators and logistics teams to assess vessel traffic in specific areas, aiding in congestion management and operational planning.
Fleet Operations
4. Batch Vessel Data
The POST /vessels/fleet endpoint allows 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": "Fleet Vessel",
"position": {
"latitude": 34.56,
"longitude": -120.45
},
"route": {
"departure_port": "Port A",
"destination_port": "Port B"
}
}
]
}
}This endpoint is essential for fleet managers who need to monitor multiple vessels simultaneously, providing a comprehensive overview of fleet status and location.
Port Intelligence
5. Port Congestion
The GET /ports/congestion endpoint provides 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": 10,
"vessels_at_berth": 5
},
"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": 50
}
}
}This endpoint is crucial for port operators and logistics teams to manage vessel arrivals and optimize berth assignments, reducing wait times and improving efficiency.
Environmental Compliance
6. IMO CII Emissions Scoring
The GET /vessels/green endpoint provides IMO CII emissions scoring for vessels, which is essential 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": "Vessel Name",
"period": "30d",
"distance_nm": 500,
"estimated_emissions": {
"co2_tons": 50,
"co2_per_nm": 0.1
},
"cii": {
"score": "B",
"rating": "Good",
"year": 2023,
"regulation_reference": "MEPC.339(76)"
}
}
}This endpoint is vital for compliance teams and organizations focused on sustainability, providing the necessary data to report on emissions and improve environmental performance.
Conclusion
The Vessels API is a comprehensive solution for accessing real-time maritime data and analytics. With its robust set of endpoints, developers can easily integrate vessel tracking, fleet management, port intelligence, and emissions scoring into their applications. Whether you are a logistics startup, fleet manager, or port operator, the Vessels API provides the tools you need to optimize operations and enhance decision-making.
Don't miss out on the opportunity to leverage powerful maritime data. Try Vessels API for free today and unlock the potential of real-time vessel tracking and analytics for your business.
Ready to get started? Get started with Vessels API and transform your maritime operations with cutting-edge data solutions.
