In the fast-paced world of maritime logistics, having access to real-time data is crucial for optimizing operations, ensuring compliance, and enhancing decision-making. The Vessels API provides developers, startups, and enterprise teams with a comprehensive REST API that offers instant access to global maritime vessel tracking data powered by AIS (Automatic Identification System). With 18 robust endpoints, the Vessels API is designed to meet the diverse needs of the maritime industry, from vessel search and live tracking to fleet operations and port intelligence.
Why Choose Vessels API?
The Vessels API stands out in the maritime data landscape for several reasons:
- Comprehensive coverage with 18 REST endpoints.
- One API key and a single base URL for seamless integration.
- Consistent JSON response structure for easy parsing.
- Global AIS coverage with near real-time refresh rates.
- Scalable solutions suitable for indie developers and enterprise fleets.
- 7-day free trial available for all plans.
Whether you are a developer building a fleet dashboard, a logistics startup optimizing ETAs, or a port operator managing vessel traffic, the Vessels API is your go-to solution for maritime data.
Key Features of the Vessels API
The Vessels API offers a wide range of endpoints that cater to various maritime data needs. Below, we will explore the most relevant endpoints for ferry tracking and their practical applications.
Vessel Intelligence
1. Search for Vessels
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.
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=atlantic&flag=Panama"Response:
{
"data": {
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Atlantic Voyager",
"flag": "Panama",
"vessel_type": "Ferry",
"gross_tonnage": 5000,
"deadweight_tonnage": 2000,
"year_built": 2010,
"length_m": 100,
"width_m": 20
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
}
}This endpoint is essential for fleet managers who need to quickly locate vessels based on various criteria, enabling efficient fleet management 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.
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=258785000&hours=48"Response:
{
"data": {
"vessel": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"current_position": {
"latitude": 34.56,
"longitude": -58.38,
"speed_knots": 20,
"course_degrees": 180,
"heading_degrees": 180,
"navigational_status": "Underway",
"timestamp_utc": "2023-10-01T12:00:00Z",
"destination": "Port of Call",
"eta": "2023-10-02T08:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "Port A",
"departure_time": "2023-10-01T10:00:00Z",
"destination_port": "Port B",
"eta": "2023-10-02T08:00:00Z",
"distance_nm": 100,
"avg_speed_knots": 20
},
"last_port_visits": [...]
}
}
}This endpoint is invaluable for logistics teams needing to track vessel movements in real-time, allowing for accurate ETAs and improved operational efficiency.
3. Nearby Vessels
The GET /vessels/nearby endpoint retrieves all vessels within a specified radius of a given latitude and longitude.
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:
{
"data": {
"center": {
"latitude": -34.60,
"longitude": -58.38
},
"radius_nm": 30,
"total": 5,
"vessels": [
{
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"ship_type": "Ferry",
"position": {
"latitude": -34.60,
"longitude": -58.38,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 10,
"speed_knots": 20,
"course_degrees": 180,
"navigational_status": "Underway"
}
]
}
}This endpoint is particularly useful for port operators and logistics teams to monitor vessel traffic in specific areas, enhancing situational awareness and safety.
Fleet Operations
4. Batch Vessel Data
The POST /vessels/fleet endpoint allows you to retrieve batch positions, routes, and statistics for multiple vessels in a single 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"Response:
{
"data": {
"fleet": {
"total_vessels": 2,
"vessels_at_sea": 1,
"vessels_in_port": 1
},
"vessels": [
{
"imo": "9122556",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"position": {
"latitude": -34.60,
"longitude": -58.38
},
"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 operations.
Port Intelligence
5. Port Congestion
The GET /ports/congestion endpoint provides real-time congestion snapshots and wait-time statistics for a specified port.
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports/congestion?port_id=ARBUE&period=7d"Response:
{
"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": 3,
"port_calls_count": 20
}
}
}This endpoint is crucial for port operators and logistics teams to manage vessel traffic effectively, reducing delays and improving service levels.
6. Expected Arrivals
The GET /port/expected-arrivals endpoint lists vessels expected to arrive at a specified port, including their ETA and origin.
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/expected-arrivals?port=ARBUE"Response:
{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"expected_arrivals": [
{
"mmsi": "258785000",
"imo": "1234567",
"name": "Atlantic Voyager",
"vessel_type": "Ferry",
"eta": "2023-10-02T08:00:00Z",
"departure_port": "Port A"
}
],
"total": 1
}
}This endpoint is particularly useful for logistics teams to plan for incoming vessels, ensuring that resources are allocated efficiently.
Conclusion
The Vessels API is a powerful tool for anyone involved in the maritime industry, providing essential data that enhances operational efficiency, compliance, and decision-making. With its comprehensive set of endpoints, real-time data capabilities, and user-friendly structure, the Vessels API is the ideal choice for developers, fleet managers, and port operators alike.
Don't miss out on the opportunity to leverage real-time maritime data for your operations. Get started with Vessels API today and experience the benefits of seamless maritime data integration.
For more information, try Vessels API for free and see how it can transform your maritime operations.
