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 a port operator, the ability to track vessels, analyze routes, and understand port conditions can significantly enhance operational efficiency. This is where Vessels API comes into play. With 18 REST endpoints covering vessel search, live tracking, fleet operations, port intelligence, and IMO CII emissions scoring, Vessels API provides developers and enterprises 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:
- Comprehensive coverage with 18 REST endpoints.
- One API key and one base URL for simplified access.
- Consistent JSON envelope in every response:
{status, success, message, data}. - Global AIS coverage with near real-time refresh rates.
- Scalable solutions suitable for indie developers to enterprise fleets.
- 7-day free trial available for all plans.
This blog post will delve into the key features of the Vessels API, focusing on the RoPax (Roll-on/Roll-off Passenger) vessel tracking capabilities. We will explore the relevant endpoints, provide code examples, and discuss practical use cases to demonstrate how Vessels API can transform maritime operations.
Vessel Intelligence Endpoints
1. Vessel Search
The GET /vessels/search endpoint allows you to find any vessel by name, IMO, or MMSI. This is particularly useful for fleet managers who need to quickly locate specific vessels within their operations.
Request 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": "RoPax",
"gross_tonnage": 30000,
"deadweight_tonnage": 15000,
"year_built": 2010,
"length_m": 200,
"width_m": 30
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
}
}The response includes essential details such as the vessel's IMO, MMSI, name, flag, type, gross tonnage, deadweight tonnage, year built, length, and width. This information is vital for fleet dashboards and operational planning.
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. This is essential for logistics teams needing accurate ETAs for planning and coordination.
Request 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": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager"
},
"current_position": {
"latitude": 34.0522,
"longitude": -118.2437,
"speed_knots": 20,
"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-01T08:00:00Z",
"destination_port": "Los Angeles",
"eta": "2023-10-02T08:00:00Z",
"distance_nm": 300,
"avg_speed_knots": 20
},
"last_port_visits": [...]
}
}This endpoint is invaluable for logistics ETAs, allowing teams to adjust plans based on real-time data. The response includes the vessel's current position, speed, course, navigational status, and detailed route information.
3. Nearby Vessels
The GET /vessels/nearby endpoint returns all vessels within a specified radius of a given latitude and longitude. This is particularly useful for port operators monitoring vessel traffic in real-time.
Request 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": "258785000",
"name": "Atlantic Voyager",
"ship_type": "RoPax",
"position": {
"latitude": -34.60,
"longitude": -58.38,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 10,
"speed_knots": 20,
"course_degrees": 90,
"navigational_status": "Underway"
}
]
}
}This data can help port operators manage congestion and optimize berth assignments by providing a snapshot of nearby vessels.
4. Vessel Analytics
The GET /vessels/analytics endpoint offers aggregated voyage statistics, allowing users to switch modes between vessel, port, or fleet analytics. This is crucial for performance tracking and operational insights.
Request 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": "1234567",
"name": "Atlantic Voyager",
"period": "7d",
"statistics": {
"total_distance_nm": 1500,
"avg_speed_knots": 18,
"max_speed_knots": 25,
"port_calls_count": 5,
"total_time_in_port_hours": 20,
"ports_visited": ["San Francisco", "Los Angeles"]
}
}
}This endpoint provides insights into vessel performance, helping fleet managers make informed decisions about routing and scheduling.
Fleet Operations Endpoint
5. Fleet Management
The POST /vessels/fleet endpoint allows users to batch request positions, routes, and statistics for multiple vessels in one go. This is particularly useful for fleet managers who need to monitor multiple vessels simultaneously.
Request 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": "Atlantic Voyager",
"position": {
"latitude": 34.0522,
"longitude": -118.2437
},
"route": {
"departure_port": "San Francisco",
"destination_port": "Los Angeles"
}
}
]
}
}This endpoint simplifies fleet management by providing a comprehensive overview of vessel statuses, enabling better operational decisions.
Port Intelligence Endpoints
6. Port Congestion
The GET /ports/congestion endpoint provides real-time congestion snapshots and wait-time statistics for a specific port. This is essential for port operators to manage traffic effectively.
Request 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": 15
}
}
}This data helps port operators optimize berth assignments and manage vessel traffic more effectively.
7. Port Activity
The GET /port/activity endpoint provides recent arrivals and departures for a specific port, which is crucial for logistics event feeds.
Request Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/activity?port=ARBUE"Response Example:
{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"arrivals": [
{
"mmsi": "258785000",
"name": "Atlantic Voyager",
"arrival_time": "2023-10-01T12:00:00Z",
"from_port": "San Francisco"
}
],
"departures": [
{
"mmsi": "258785000",
"name": "Atlantic Voyager",
"departure_time": "2023-10-01T14:00:00Z",
"to_port": "Los Angeles"
}
]
}
}This endpoint provides real-time updates on vessel movements, enabling logistics teams to stay informed about port operations.
Conclusion
In conclusion, Vessels API offers a robust solution for accessing real-time maritime data and analytics. With its comprehensive set of endpoints, developers can easily integrate vessel tracking, fleet management, and port intelligence into their applications. The API's consistent response structure and detailed data make it an invaluable tool for anyone involved in maritime logistics.
Don't miss out on the opportunity to enhance your maritime operations. Try Vessels API for free and experience the power of real-time maritime data at your fingertips. Get started with Vessels API today!
