In the fast-paced world of maritime logistics, having access to real-time vessel tracking and analytics is crucial for optimizing operations, ensuring compliance, and enhancing decision-making. The Vessels API offers a comprehensive solution with its multi-purpose vessel tracking API, providing developers, startups, and enterprise teams with instant access to global maritime data powered by AIS. With 18 REST endpoints covering vessel search, live tracking, fleet operations, port intelligence, and IMO CII emissions scoring, this 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:
- 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.
Whether you are a developer building a fleet dashboard, a logistics startup optimizing ETAs, or a port operator managing operations, the Vessels API provides the tools you need to succeed.
Key Features and Endpoints
Vessel Intelligence
The Vessel Intelligence endpoints allow users to search for vessels, track their live positions, and analyze their performance. Here are some of the most relevant endpoints:
1. Vessel Search
The /vessels/search endpoint enables users to find any vessel by name, IMO, or MMSI. Optional filters allow for more refined searches based on ship type, flag, and other parameters.
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": "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 essential for logistics teams needing to quickly identify vessels for tracking or operational planning.
2. Live Vessel Tracking
The /vessels/track endpoint provides live position data, including up to 168 hours of position history, active routes, predicted ETAs, and weather conditions.
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": "2587850",
"mmsi": "258785000",
"name": "Nordic Star"
},
"current_position": {
"latitude": 34.56,
"longitude": -120.45,
"speed_knots": 12,
"course_degrees": 180,
"heading_degrees": 180,
"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 invaluable for fleet managers who need to monitor vessel movements in real-time and optimize logistics operations.
3. Nearby Vessels
The /vessels/nearby endpoint allows users to find all vessels within a specified radius of a given latitude and longitude.
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": "123456789",
"name": "Atlantic Voyager",
"ship_type": "Cargo",
"position": {
"latitude": -34.60,
"longitude": -58.38,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 10,
"speed_knots": 10,
"course_degrees": 90,
"navigational_status": "At Anchor"
}
]
}
}This endpoint is particularly useful for port operators and logistics teams looking to assess vessel traffic in specific areas.
Fleet Operations
The Fleet Operations endpoints provide batch processing capabilities for managing multiple vessels simultaneously.
4. Fleet Management
The /vessels/fleet endpoint allows users to retrieve batch positions, routes, and statistics for multiple vessels in a single request.
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": "Vessel One",
"position": {
"latitude": 34.56,
"longitude": -120.45
},
"route": {
"departure_port": "San Francisco",
"destination_port": "Los Angeles"
}
}
]
}
}This endpoint is essential for fleet managers who need to monitor multiple vessels efficiently and make informed decisions based on real-time data.
Port Intelligence
The Port Intelligence endpoints provide insights into port operations, including congestion and expected arrivals.
5. Port Congestion
The /ports/congestion endpoint offers real-time congestion snapshots and wait-time statistics for a specific port.
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": 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 to manage vessel traffic and optimize berth allocation.
6. Expected Arrivals
The /port/expected-arrivals endpoint provides information on vessels expected to arrive at a specific port, including their ETA and origin.
cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/expected-arrivals?port=ARBUE"Response Example:
{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"expected_arrivals": [
{
"mmsi": "123456789",
"imo": "1234567",
"name": "Atlantic Voyager",
"vessel_type": "Cargo",
"eta": "2023-10-02T08:00:00Z",
"departure_port": "San Francisco"
}
],
"total": 1
}
}This endpoint is beneficial for logistics teams to plan for incoming vessels and manage cargo operations effectively.
IMO CII Emissions Scoring
The /vessels/green endpoint provides IMO CII emissions scoring, which is essential for ESG reporting and regulatory compliance.
cURL Example:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/green?mmsi=258785000&period=30d"Response Example:
{
"data": {
"imo": "2587850",
"mmsi": "258785000",
"name": "Nordic Star",
"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 critical for compliance teams to assess vessel emissions and ensure adherence to environmental regulations.
Conclusion
The Vessels API is a powerful tool for anyone involved in the maritime industry, providing essential data and analytics for vessel tracking, fleet operations, port intelligence, and emissions scoring. With its comprehensive set of endpoints, developers can easily integrate maritime data into their applications, enhancing operational efficiency and decision-making.
Don't miss out on the opportunity to leverage real-time maritime data. Try Vessels API for free today and see how it can transform your maritime operations.
Ready to get started? Visit Get started with Vessels API and unlock the potential of maritime data analytics.
