In the fast-paced world of maritime logistics, having access to real-time vessel tracking data is crucial for optimizing operations, ensuring safety, and enhancing decision-making. The Vessels API offers a comprehensive solution for developers, startups, and enterprise teams looking to harness global maritime data through its robust REST API. With 17 endpoints covering vessel search, live AIS 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 that provide extensive coverage of vessel tracking and operational data.
- One API key and a single base URL for seamless integration.
- Consistent JSON response structure, making it easy to parse and utilize data.
- Global AIS coverage with near real-time refresh rates, ensuring timely data access.
- A 7-day free trial available for all plans, allowing users to explore the API's capabilities.
Whether you are a developer building a logistics application, a fleet manager optimizing operations, or an ESG team ensuring compliance, the Vessels API provides the tools you need to succeed.
Key Features of the Vessels API
Vessel Intelligence
The Vessel Intelligence endpoints allow users to search for vessels, track their positions, and analyze their performance. Here are some of the most relevant endpoints:
1. Vessel Search
The GET /vessels/search endpoint enables users to find any vessel by name, IMO, or MMSI. Optional filters such as ship type, flag, and year built can be applied to refine search results.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=atlantic&flag=Panama"Example 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": 250,
"width_m": 40
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
}
}This endpoint is invaluable for logistics applications that need to quickly locate vessels based on various criteria, enhancing operational efficiency.
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 Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=258785000&hours=48"Example Response:
{
"status": 200,
"success": true,
"message": "Tracking data",
"data": {
"vessel": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager"
},
"current_position": {
"latitude": 34.56,
"longitude": -120.34,
"speed_knots": 12,
"course_degrees": 180,
"heading_degrees": 180,
"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": 12
},
"last_port_visits": [...]
}
}This endpoint is essential for fleet managers who need to monitor vessel movements in real-time, allowing for proactive decision-making and improved logistics planning.
3. Nearby Vessels
The GET /vessels/nearby endpoint retrieves 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:
{
"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": 12,
"course_degrees": 180,
"navigational_status": "Under way"
}
]
}
}This feature is particularly useful for port operators and logistics teams who need to assess vessel traffic in specific areas, enhancing safety and operational efficiency.
Fleet Operations
The Fleet Operations endpoints allow users to manage multiple vessels efficiently. Key endpoints include:
1. Batch Fleet Data
The POST /vessels/fleet endpoint enables users to retrieve batch positions, routes, and statistics for multiple vessels in a single request.
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,"include_routes":true}' "https://vessels-api.com/api/V1/vessels/fleet"Example Response:
{
"status": 200,
"success": true,
"message": "Fleet data retrieved",
"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 invaluable for fleet managers who need to monitor and manage multiple vessels efficiently, reducing operational overhead and improving response times.
2. IMO CII Emissions Scoring
The GET /vessels/green endpoint provides IMO CII emissions scoring for vessels, which is essential 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:
{
"status": 200,
"success": true,
"message": "CII 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 crucial for companies aiming to meet environmental regulations and improve their sustainability practices.
Port Intelligence
The Port Intelligence endpoints provide insights into port operations, congestion, and expected arrivals. Key endpoints include:
1. Port Congestion
The GET /ports/congestion endpoint offers real-time congestion snapshots and wait-time statistics for a specific port.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports/congestion?port_id=ARBUE&period=7d"Example 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": 10
},
"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": 50
}
}
}This endpoint is essential for port operators to manage vessel traffic effectively and minimize delays.
2. Expected Arrivals
The GET /port/expected-arrivals endpoint provides information on vessels expected to arrive at a specific port, including their ETA and origin.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/expected-arrivals?port=ARBUE"Example Response:
{
"status": 200,
"success": true,
"message": "Expected arrivals data",
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"expected_arrivals": [
{
"mmsi": "258785000",
"imo": "1234567",
"name": "Atlantic Voyager",
"vessel_type": "Cargo",
"eta": "2023-10-15T12:00:00Z",
"departure_port": "San Francisco"
}
],
"total": 1
}
}This endpoint is vital for logistics teams to plan for incoming vessels and allocate resources accordingly.
Conclusion
The Vessels API is a powerful tool for anyone involved in maritime logistics, offering a wealth of data and insights that can significantly enhance operational efficiency and decision-making. With its comprehensive endpoints covering vessel tracking, fleet operations, and port intelligence, the Vessels API is designed to meet the diverse needs of developers and businesses in the maritime industry.
Don't miss out on the opportunity to leverage real-time maritime data for your applications. Try Vessels API for free today and discover how it can transform your maritime operations.
For more information and to get started, visit Get started with Vessels API.
