In the fast-paced world of maritime logistics, having access to real-time data is crucial for making informed decisions. Whether you are a fleet manager, a logistics startup, or part of an ESG compliance team, the ability to track vessels, analyze port conditions, and assess emissions is vital. This is where Vessels API comes into play, offering a comprehensive REST API that provides developers with instant access to global maritime vessel tracking data powered by AIS. With 18 endpoints covering vessel search, live tracking, fleet operations, port intelligence, and IMO CII emissions scoring, Vessels API is designed to meet the needs of various maritime stakeholders.
Why Choose Vessels API?
Vessels API stands out in the maritime data landscape for several reasons:
- Comprehensive Coverage: With 18 REST endpoints, you can access a wide range of maritime data.
- Unified Access: One API key and one base URL simplify the authentication process.
- Consistent Responses: Every response follows a standard JSON envelope, making it easy to parse and integrate.
- Global AIS Coverage: Near real-time refresh rates ensure you have the latest data at your fingertips.
- Scalable Solutions: Whether you are an indie developer or managing an enterprise fleet, Vessels API scales to your needs.
- Free Trial: Explore the API with a 7-day free trial to see how it can benefit your operations.
Key Features of Vessels API
Let’s delve into the most relevant endpoints for vessel tracking and analytics, showcasing their capabilities and practical applications.
Vessel Search
The GET /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.
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": 250,
"width_m": 40
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
}
}This endpoint is essential for logistics teams needing to quickly identify vessels for tracking or operational planning.
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:
{
"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": "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-01T10:00:00Z",
"destination_port": "Los Angeles",
"eta": "2023-10-02T08:00:00Z",
"distance_nm": 300,
"avg_speed_knots": 15
},
"last_port_visits": [...]
}
}This endpoint is invaluable for fleet managers who need to monitor vessel movements in real-time, ensuring timely arrivals and efficient operations.
Nearby Vessels
The GET /vessels/nearby endpoint allows you 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:
{
"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": 15,
"course_degrees": 90,
"navigational_status": "Underway"
}
]
}
}This feature is particularly useful for port operators and logistics teams looking to assess traffic in specific areas.
Vessel Analytics
The GET /vessels/analytics endpoint provides aggregated voyage statistics, allowing you to switch modes between vessel, port, or fleet analytics.
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": 500,
"avg_speed_knots": 12,
"max_speed_knots": 18,
"port_calls_count": 3,
"total_time_in_port_hours": 24,
"ports_visited": ["San Francisco", "Los Angeles"]
}
}
}This endpoint is essential for fleet managers and logistics teams to evaluate performance metrics and optimize operations.
Fleet Operations
The POST /vessels/fleet endpoint allows you to batch positions, routes, and statistics for multiple vessels in one request, streamlining fleet management.
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": "309374000",
"name": "Atlantic Voyager",
"position": {...},
"route": {...}
}
]
}
}This endpoint is a game-changer for fleet managers, allowing them to monitor multiple vessels simultaneously and make data-driven decisions.
IMO CII Emissions Scoring
The GET /vessels/green endpoint provides IMO CII emissions scoring, which is crucial 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:
{
"data": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"period": "30d",
"distance_nm": 500,
"estimated_emissions": {
"co2_tons": 100,
"co2_per_nm": 0.2
},
"cii": {
"score": "B",
"rating": "Good",
"year": 2023,
"regulation_reference": "IMO MEPC.339(76)"
}
}
}This endpoint is essential for companies focused on sustainability and compliance with international regulations.
Conclusion
In a world where maritime logistics are becoming increasingly complex, having access to reliable and comprehensive data is more important than ever. The Vessels API provides developers and organizations with the tools they need to track vessels, analyze port conditions, and assess emissions effectively. With its robust set of endpoints and user-friendly design, Vessels API is the go-to solution for anyone looking to leverage maritime data for operational excellence.
Don't miss out on the opportunity to enhance your maritime operations. Try Vessels API for free today and see how it can transform your approach to vessel tracking and analytics.
Ready to get started? Get started with Vessels API and unlock the potential of real-time maritime data.
