Introduction
In the maritime industry, real-time data and analytics are crucial for effective decision-making. Whether you are a fleet manager, a logistics startup, or a port operator, having access to accurate vessel tracking information can significantly enhance operational efficiency. The Vessels API offers a comprehensive solution with its robust REST API, providing developers and businesses with instant access to global maritime vessel tracking data powered by AIS (Automatic Identification System). This blog post will delve into the features and capabilities of the Vessels API, focusing on its 17 endpoints that cover vessel search, live tracking, fleet operations, port intelligence, and IMO CII emissions scoring.
Why Choose Vessels API?
The Vessels API stands out in the maritime data landscape for several reasons:
- Comprehensive coverage with 17 REST endpoints.
- One API key and one base URL for simplified access.
- Consistent JSON response structure across all endpoints.
- 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.
With these features, the Vessels API is designed to meet the needs of developers, logistics startups, fleet managers, port operators, and ESG/compliance teams.
Vessel Intelligence Endpoints
1. Vessel Search
The GET /vessels/search endpoint allows users to find any vessel by name, IMO, or MMSI. This endpoint supports optional filters such as ship type, flag, and year built, making it versatile for various use cases.
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": "Vessels found",
"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": 200,
"width_m": 30
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
}
}This endpoint is invaluable for logistics companies needing to track specific vessels or for compliance teams verifying vessel details.
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 endpoint requires either the IMO or MMSI number.
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": "Vessel tracking data retrieved",
"data": {
"vessel": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager"
},
"current_position": {
"latitude": 34.56,
"longitude": -120.45,
"speed_knots": 15,
"course_degrees": 270,
"heading_degrees": 270,
"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": 15
},
"last_port_visits": [...]
}
}This endpoint is essential for fleet managers who need to monitor vessel movements in real-time and optimize logistics accordingly.
3. Nearby Vessels
The GET /vessels/nearby endpoint retrieves all vessels within a specified radius of a given latitude and longitude. This is particularly useful for port operators and logistics teams needing situational awareness of nearby vessels.
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 retrieved",
"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": 5,
"speed_knots": 12,
"course_degrees": 180,
"navigational_status": "Under way"
}
]
}
}This endpoint helps logistics teams plan for incoming vessels and manage port congestion effectively.
4. Vessel Analytics
The GET /vessels/analytics endpoint provides aggregated voyage statistics for vessels, ports, or fleets. This data is crucial for performance analysis and operational efficiency.
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:
{
"status": 200,
"success": true,
"message": "Analytics data retrieved",
"data": {
"type": "vessel",
"mmsi": "258785000",
"imo": "1234567",
"name": "Atlantic Voyager",
"period": "7d",
"statistics": {
"total_distance_nm": 1500,
"avg_speed_knots": 12,
"max_speed_knots": 20,
"port_calls_count": 5,
"total_time_in_port_hours": 48,
"ports_visited": ["San Francisco", "Los Angeles", "Seattle"]
}
}
}This endpoint is invaluable for fleet managers looking to optimize routes and improve overall fleet performance.
Fleet Operations Endpoints
5. Fleet Management
The POST /vessels/fleet endpoint allows users to batch request positions, routes, and statistics for multiple vessels in one request. This is particularly useful for large fleets.
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:
{
"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 simplifies fleet management by providing a comprehensive overview of multiple vessels in a single API call.
6. 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 retrieved",
"data": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"period": "30d",
"distance_nm": 1500,
"estimated_emissions": {
"co2_tons": 100,
"co2_per_nm": 0.067
},
"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 Endpoints
7. Port Congestion
The GET /ports/congestion endpoint provides real-time congestion snapshots and wait-time statistics for a specified port. This data is essential for port operators and logistics teams.
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 retrieved",
"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": 50
}
}
}This endpoint helps port operators manage congestion and improve turnaround times for vessels.
8. Full Port Catalog
The GET /ports endpoint provides a full catalog of ports, including identifiers, coordinates, and country information. This is useful for logistics planning and operational coordination.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports"Example Response:
{
"status": 200,
"success": true,
"message": "Ports data retrieved",
"data": {
"ports": [
{
"port_id": "ARBUE",
"name": "Port of Buenos Aires",
"country": "Argentina",
"latitude": -34.60,
"longitude": -58.38,
"timezone": "America/Argentina/Buenos_Aires"
}
],
"total": 248
}
}This endpoint is essential for logistics teams needing to identify and coordinate with various ports globally.
9. Port Data
The GET /ports/data endpoint provides detailed information for a single port, including live vessel counts. This is crucial for operational planning and resource allocation.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports/data?port=ARBUE"Example Response:
{
"status": 200,
"success": true,
"message": "Port data retrieved",
"data": {
"port_id": "ARBUE",
"name": "Port of Buenos Aires",
"country": "Argentina",
"latitude": -34.60,
"longitude": -58.38,
"timezone": "America/Argentina/Buenos_Aires",
"vessels_in_port": 15,
"vessels_expected": 5
}
}This endpoint helps port operators manage incoming and outgoing vessel traffic effectively.
10. Expected Arrivals
The GET /port/expected-arrivals endpoint provides information on vessels expected to arrive at a port, including ETA and origin. This is vital for logistics planning and resource allocation.
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 retrieved",
"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 crucial for logistics teams to prepare for incoming vessels and manage port operations efficiently.
11. Port Activity
The GET /port/activity endpoint provides recent arrivals and departures for a specified port, which is essential for tracking logistics events.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/activity?port=ARBUE"Example Response:
{
"status": 200,
"success": true,
"message": "Port activity data retrieved",
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"arrivals": [
{
"mmsi": "258785000",
"name": "Atlantic Voyager",
"arrival_time": "2023-10-15T12:00:00Z",
"from_port": "San Francisco"
}
],
"departures": [
{
"mmsi": "258785001",
"name": "Pacific Explorer",
"departure_time": "2023-10-14T10:00:00Z",
"to_port": "Los Angeles"
}
]
}
}This endpoint helps logistics teams stay informed about vessel movements in and out of ports.
Conclusion
The Vessels API provides a powerful suite of tools for accessing maritime data, enabling developers and businesses to enhance their operations significantly. With endpoints covering vessel search, live tracking, fleet operations, and port intelligence, the API is designed to meet the diverse needs of the maritime industry.
By leveraging the capabilities of the Vessels API, organizations can optimize logistics, improve fleet management, and ensure compliance with environmental regulations. The API's comprehensive data offerings and real-time analytics empower users to make informed decisions, ultimately leading to increased efficiency and reduced operational costs.
To get started with the Vessels API and explore its features, visit Vessels API today!
