In the maritime industry, real-time data and analytics are crucial for efficient operations, safety, and compliance. With the increasing complexity of global shipping and logistics, having access to accurate vessel tracking information is more important than ever. This is where the Vessels API comes into play, offering a comprehensive suite of endpoints designed to meet the needs of developers, logistics startups, fleet managers, and port operators.
Why Choose Vessels API?
The Vessels API provides 18 REST endpoints that cover a wide range of functionalities, including vessel search, live tracking, fleet operations, port intelligence, and IMO CII emissions scoring. Here are some key advantages:
- One API key and one base URL for all endpoints, simplifying authentication.
- Consistent JSON envelope on every response: {status, success, message, data}.
- Global AIS coverage with near real-time refresh rates.
- 7-day free trial available for all plans, making it accessible for indie developers and enterprise fleets alike.
Vessel Tracking and Analytics
The Vessels API offers several endpoints that allow users to track vessels in real-time and analyze their movements. This is particularly useful for fleet managers and logistics companies looking to optimize their operations.
1. 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 deadweight tonnage.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=atlantic&flag=Panama"Example Response:
{
"status": 200,
"success": true,
"message": "Vessels found",
"data": {
"vessels": [
{
"imo": "9702510",
"mmsi": "258785000",
"name": "ZJ ATLANTIC",
"flag": "Liberia",
"vessel_type": "Bulk Carrier",
"gross_tonnage": "36332",
"deadweight_tonnage": "60000",
"year_built": "2015",
"length_m": "199.90",
"width_m": "32.26"
}
],
"pagination": {
"current_page": 1,
"per_page": 1,
"total": 1,
"last_page": 1
}
}
}This endpoint is invaluable for logistics companies 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.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=258785000&hours=48"Example Response:
{
"status": 200,
"success": true,
"message": "Vessel tracking data retrieved",
"data": {
"vessel": {
"imo": "9702510",
"mmsi": "258785000",
"name": "ZJ ATLANTIC"
},
"current_position": {
"latitude": "6.39686",
"longitude": "3.40037",
"speed_knots": "7.9",
"course_degrees": "180",
"heading_degrees": "180",
"navigational_status": "Under way using engine",
"timestamp_utc": "2023-10-13T10:36:00Z",
"destination": "Port of Lagos",
"eta": "2023-10-15T12:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "Port Klang, Malaysia",
"departure_time": "2023-10-11T00:45:00Z",
"destination_port": "Port of Lagos",
"eta": "2023-10-15T12:00:00Z",
"distance_nm": "1200",
"avg_speed_knots": "7.5"
},
"last_port_visits": [...]
}
}This endpoint is essential for fleet managers who need to monitor vessel movements in real-time, allowing for better decision-making and operational efficiency.
3. Nearby Vessels
The GET /vessels/nearby endpoint allows users to find all vessels within a specified radius of a given latitude and longitude.
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:
{
"status": 200,
"success": true,
"message": "Nearby vessels retrieved",
"data": {
"center": {
"latitude": -34.60,
"longitude": -58.38
},
"radius_nm": 30,
"total": 5,
"vessels": [
{
"imo": "9702510",
"mmsi": "258785000",
"name": "ZJ ATLANTIC",
"ship_type": "Bulk Carrier",
"position": {
"latitude": "6.39686",
"longitude": "3.40037",
"timestamp_utc": "2023-10-13T10:36:00Z"
},
"distance_nm": "25",
"speed_knots": "7.9",
"course_degrees": "180",
"navigational_status": "Under way using engine"
}
]
}
}This feature is particularly useful for port operators and logistics teams who need to assess vessel traffic in specific areas for operational planning and safety.
Fleet Operations
Managing a fleet of vessels requires comprehensive data on each vessel's status, routes, and performance metrics. The Vessels API provides several endpoints tailored for fleet operations.
4. Fleet Data
The POST /vessels/fleet endpoint allows users to batch request positions, routes, and statistics for multiple vessels in one request.
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,"include_routes":true}' "https://vessels-api.com/api/V1/vessels/fleet"Example Response:
{
"status": 200,
"success": true,
"message": "Fleet data retrieved",
"data": {
"fleet": {
"total_vessels": 2,
"vessels_at_sea": 1,
"vessels_in_port": 1
},
"vessels": [
{
"imo": "9122556",
"mmsi": "309374000",
"name": "Vessel A",
"position": {
"latitude": "6.39686",
"longitude": "3.40037"
},
"route": {
"departure_port": "Port Klang",
"destination_port": "Port of Lagos",
"eta": "2023-10-15T12:00:00Z"
}
}
]
}
}This endpoint is invaluable for fleet managers who need to monitor multiple vessels simultaneously, allowing for efficient resource allocation and operational oversight.
5. Vessel Analytics
The GET /vessels/analytics endpoint provides aggregated voyage statistics for vessels, ports, or fleets, enabling users to analyze performance over specified periods.
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:
{
"status": 200,
"success": true,
"message": "Analytics data retrieved",
"data": {
"type": "vessel",
"mmsi": "258785000",
"imo": "9702510",
"name": "ZJ ATLANTIC",
"period": "7d",
"statistics": {
"total_distance_nm": "1200",
"avg_speed_knots": "7.5",
"max_speed_knots": "9.0",
"port_calls_count": 3,
"total_time_in_port_hours": 48,
"ports_visited": ["Port Klang", "Port of Lagos"]
}
}
}This endpoint is essential for performance analysis, helping fleet managers identify trends and optimize routes for efficiency.
Port Intelligence
Understanding port operations and congestion is vital for effective logistics management. The Vessels API provides endpoints that deliver real-time port intelligence.
6. Port Congestion
The GET /ports/congestion endpoint provides real-time congestion snapshots and wait-time statistics for a specified port.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports/congestion?port_id=ARBUE&period=7d"Example Response:
{
"status": 200,
"success": true,
"message": "Congestion data retrieved",
"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 logistics teams to plan arrivals and departures effectively, minimizing delays and optimizing berth usage.
7. Expected Arrivals
The GET /port/expected-arrivals endpoint provides information on vessels expected to arrive at a specified port, including their ETA and origin.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/expected-arrivals?port=ARBUE"Example Response:
{
"status": 200,
"success": true,
"message": "Expected arrivals retrieved",
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"expected_arrivals": [
{
"mmsi": "258785000",
"imo": "9702510",
"name": "ZJ ATLANTIC",
"vessel_type": "Bulk Carrier",
"eta": "2023-10-15T12:00:00Z",
"departure_port": "Port Klang"
}
],
"total": 1
}
}This endpoint helps port operators manage incoming traffic and prepare for vessel arrivals, ensuring smooth operations.
Environmental Compliance
With increasing regulatory scrutiny on emissions, the Vessels API provides endpoints for tracking vessels' environmental performance.
8. 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.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/green?mmsi=258785000&period=30d"Example Response:
{
"status": 200,
"success": true,
"message": "Emissions data retrieved",
"data": {
"imo": "9702510",
"mmsi": "258785000",
"name": "ZJ ATLANTIC",
"period": "30d",
"distance_nm": "1200",
"estimated_emissions": {
"co2_tons": "150",
"co2_per_nm": "0.125"
},
"cii": {
"score": "B",
"rating": "Good",
"year": "2023",
"regulation_reference": "IMO MEPC.339(76)"
}
}
}This endpoint is vital for companies looking to meet environmental regulations and improve their sustainability practices.
Conclusion
The Vessels API is a powerful tool for anyone involved in the maritime industry, providing essential data for vessel tracking, fleet management, port operations, and environmental compliance. With its comprehensive suite of endpoints, developers can easily integrate maritime data into their applications, enhancing operational efficiency and decision-making.
To get started with the Vessels API, visit Vessels API for free and explore how it can transform your maritime operations.
