In the maritime industry, real-time data and analytics are crucial for effective fleet management, logistics planning, and operational efficiency. The Vessels API offers a comprehensive solution with its REST API, providing developers, startups, and enterprise teams instant access to global maritime vessel tracking data powered by AIS. This blog post will delve into the capabilities of the Vessels API, focusing on its endpoints that cater specifically to landing craft tracking, live AIS tracking, fleet operations, port intelligence, and emissions scoring.
Why Choose Vessels API?
The 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.
- Consistent JSON envelope on every response:
{status, success, message, data}. - Global AIS coverage with near real-time refresh rates.
- A 7-day free trial on all plans, making it accessible for indie developers to enterprise fleets.
Target users include developers, logistics startups, fleet managers, port operators, and ESG/compliance teams, all of whom can benefit from the rich data provided by the Vessels API.
Key Features of the Vessels API
Vessel Intelligence
The Vessels API provides a suite of endpoints that deliver critical vessel intelligence, enabling users to track and analyze vessel movements effectively.
1. Vessel Search
The GET /vessels/search endpoint allows users to find any vessel by name, IMO, or MMSI. Optional filters such as ship type, flag, and dimensions can refine the search.
Example cURL request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=atlantic&flag=Panama"Example JSON response:
{
"status": 200,
"success": true,
"message": "Search results",
"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 logistics companies needing to identify vessels quickly 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 cURL request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=258785000&hours=48"Example JSON response:
{
"status": 200,
"success": true,
"message": "Vessel tracking data",
"data": {
"vessel": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager"
},
"current_position": {
"latitude": 34.56,
"longitude": -120.45,
"speed_knots": 15,
"course_degrees": 90,
"heading_degrees": 90,
"navigational_status": "Under way",
"timestamp_utc": "2023-10-13T10:36:00Z",
"destination": "Los Angeles",
"eta": "2023-10-15T12:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "San Francisco",
"departure_time": "2023-10-12T08:00:00Z",
"destination_port": "Los Angeles",
"eta": "2023-10-15T12:00:00Z",
"distance_nm": 300,
"avg_speed_knots": 15
},
"last_port_visits": [...]
}
}This endpoint is essential for fleet managers who need to monitor vessel movements in real-time, ensuring timely arrivals and optimizing logistics.
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 cURL 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 JSON response:
{
"status": 200,
"success": true,
"message": "Nearby vessels",
"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-13T10:36:00Z"
},
"distance_nm": 10,
"speed_knots": 15,
"course_degrees": 90,
"navigational_status": "Under way"
}
]
}
}This feature is particularly useful for port operators and logistics teams to assess vessel traffic in specific areas, enhancing operational efficiency.
4. Vessel Analytics
The GET /vessels/analytics endpoint provides aggregated voyage statistics, allowing users to analyze performance over different periods.
Example cURL request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/analytics?type=vessel&mmsi=258785000&period=7d"Example JSON response:
{
"status": 200,
"success": true,
"message": "Analytics data",
"data": {
"type": "vessel",
"mmsi": "258785000",
"imo": "1234567",
"name": "Atlantic Voyager",
"period": "7d",
"statistics": {
"total_distance_nm": 300,
"avg_speed_knots": 15,
"max_speed_knots": 20,
"port_calls_count": 5,
"total_time_in_port_hours": 10,
"ports_visited": ["San Francisco", "Los Angeles"]
}
}
}This endpoint is invaluable for fleet managers looking to optimize routes and improve operational efficiency by analyzing historical performance data.
Fleet Operations
The Vessels API also supports fleet operations through batch processing capabilities, allowing users to manage multiple vessels simultaneously.
5. Fleet Management
The POST /vessels/fleet endpoint enables users to retrieve batch positions, routes, and statistics for multiple vessels in one request.
Example cURL 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 JSON response:
{
"status": 200,
"success": true,
"message": "Fleet data",
"data": {
"fleet": {
"total_vessels": 2,
"vessels_at_sea": 1,
"vessels_in_port": 1
},
"vessels": [
{
"imo": "9122556",
"mmsi": "309374000",
"name": "Atlantic Voyager",
"position": {
"latitude": -34.60,
"longitude": -58.38
},
"route": {
"departure_port": "San Francisco",
"destination_port": "Los Angeles"
}
}
]
}
}This endpoint is essential for fleet managers who need to monitor multiple vessels efficiently, ensuring optimal resource allocation and operational effectiveness.
Port Intelligence
Understanding port conditions is vital for effective maritime operations. The Vessels API provides several endpoints dedicated to port intelligence.
6. Port Congestion
The GET /ports/congestion endpoint provides real-time congestion snapshots and wait-time statistics for a specified port.
Example cURL request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports/congestion?port_id=ARBUE&period=7d"Example JSON response:
{
"status": 200,
"success": true,
"message": "Congestion data",
"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": 4,
"port_calls_count": 20
}
}
}This endpoint is crucial for logistics teams to plan arrivals and departures effectively, minimizing delays and optimizing port operations.
7. Port Activity
The GET /port/activity endpoint provides recent arrivals and departures for logistics event feeds.
Example cURL request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/activity?port=ARBUE"Example JSON response:
{
"status": 200,
"success": true,
"message": "Port activity data",
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"arrivals": [
{
"mmsi": "258785000",
"name": "Atlantic Voyager",
"arrival_time": "2023-10-13T10:36:00Z",
"from_port": "San Francisco"
}
],
"departures": [
{
"mmsi": "258785001",
"name": "Pacific Explorer",
"departure_time": "2023-10-12T08:00:00Z",
"to_port": "Los Angeles"
}
]
}
}This endpoint is essential for port operators to track vessel movements and manage logistics effectively.
IMO CII Emissions Scoring
With increasing regulatory scrutiny on emissions, the Vessels API provides endpoints for tracking and reporting emissions data.
8. Emissions Scoring
The GET /vessels/green endpoint provides IMO CII emissions scoring for ESG reporting and regulatory compliance.
Example cURL request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/green?mmsi=258785000&period=30d"Example JSON response:
{
"status": 200,
"success": true,
"message": "Emissions data",
"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 is vital for compliance teams to monitor emissions and ensure adherence to environmental regulations.
Conclusion
The Vessels API is a powerful tool for anyone involved in maritime operations, providing essential data for vessel tracking, fleet management, port intelligence, and emissions reporting. By leveraging the comprehensive endpoints offered by the Vessels API, developers can build robust applications that enhance operational efficiency and compliance in the maritime industry.
Ready to get started? Try Vessels API for free and unlock the potential of real-time maritime data!
