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 powerful REST API that offers comprehensive maritime vessel tracking data powered by AIS (Automatic Identification System). With 17 endpoints covering vessel search, live tracking, fleet operations, port intelligence, and IMO CII emissions scoring, the Vessels API is designed to meet the diverse needs of the maritime industry.
Why Choose Vessels API?
The Vessels API stands out in the maritime data landscape for several reasons:
- 18 REST endpoints covering a wide range of functionalities.
- One API key and a single base URL for seamless integration.
- Consistent JSON envelope in every response, simplifying data handling.
- Global AIS coverage with near real-time refresh rates.
- Scalable solutions suitable for indie developers and enterprise fleets alike.
- 7-day free trial available for all plans.
This blog post will delve into the key features of the Vessels API, focusing on the endpoints most relevant to cable layer vessel tracking, and provide practical examples to illustrate their use.
Vessel Intelligence Endpoints
The Vessels API offers several endpoints that provide critical intelligence about vessels. Here are the most relevant ones:
1. Vessel Search
The GET /vessels/search endpoint allows users to find any vessel by name, IMO, or MMSI. This is particularly useful for logistics companies needing to track specific vessels quickly.
cURL 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": "Cable Layer",
"gross_tonnage": 50000,
"deadweight_tonnage": 20000,
"year_built": 2010,
"length_m": 150,
"width_m": 30
}
],
"pagination": {
"current_page": 1,
"per_page": 1,
"total": 1,
"last_page": 1
}
}
}This endpoint is essential for fleet managers who need to quickly locate vessels for 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 invaluable for real-time decision-making.
cURL 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.56,
"longitude": -120.45,
"speed_knots": 12,
"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": 12
},
"last_port_visits": [...]
}
}This endpoint is crucial for logistics teams to monitor vessel movements and optimize supply chain operations.
3. Nearby Vessels
The GET /vessels/nearby endpoint allows users to find all vessels within a specified radius of a given latitude and longitude. This is particularly useful for port operators and logistics teams needing to assess nearby traffic.
cURL 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": "Cable Layer",
"position": {
"latitude": -34.60,
"longitude": -58.38,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 10,
"speed_knots": 12,
"course_degrees": 90,
"navigational_status": "Underway"
}
]
}
}This endpoint helps port operators manage congestion and plan for incoming vessels.
4. Vessel Analytics
The GET /vessels/analytics endpoint provides aggregated voyage statistics, which can be filtered by vessel, port, or fleet. This is essential for performance tracking and operational efficiency.
cURL 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": 10,
"max_speed_knots": 15,
"port_calls_count": 5,
"total_time_in_port_hours": 20,
"ports_visited": ["San Francisco", "Los Angeles"]
}
}
}This endpoint is invaluable for fleet managers looking to optimize routes and improve operational efficiency.
Fleet Operations Endpoint
The Vessels API also provides a dedicated endpoint for fleet operations:
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 large fleets.
cURL 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.56,
"longitude": -120.45
},
"route": {
"departure_port": "San Francisco",
"destination_port": "Los Angeles"
}
}
]
}
}This endpoint simplifies fleet management by providing a comprehensive overview of multiple vessels in a single request.
Port Intelligence Endpoints
Understanding port operations is crucial for effective maritime logistics. The Vessels API offers 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 specific port. This is essential for optimizing port operations and reducing delays.
cURL 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 endpoint helps port operators manage vessel traffic and improve turnaround times.
7. Port Activity
The GET /port/activity endpoint provides recent arrivals and departures for a specific port, which is useful for logistics event feeds.
cURL 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 is essential for keeping stakeholders informed about vessel movements in and out of ports.
Conclusion
The Vessels API is a powerful tool for anyone involved in maritime logistics, offering a comprehensive suite of endpoints that provide real-time data and analytics. Whether you are a developer building a fleet management dashboard, a logistics startup optimizing ETAs, or a port operator managing vessel traffic, the Vessels API has the capabilities you need.
With its user-friendly design, consistent response structure, and extensive coverage, the Vessels API is the go-to solution for maritime data. Don't miss out on the opportunity to enhance your operations with real-time maritime data.
Get started with Vessels API today and unlock the potential of real-time maritime data for your business!
