In the fast-paced world of maritime logistics, having access to real-time vessel tracking 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 data, including vessel search, live AIS tracking, fleet operations, port intelligence, and IMO CII emissions scoring. This blog post will delve into the capabilities of the Vessels API, focusing on its 17 endpoints that cater to various maritime data needs.
Why Choose Vessels API?
The Vessels API stands out in the maritime data landscape for several reasons:
- 18 REST endpoints covering vessel search, live tracking, fleet operations, port intelligence, and emissions scoring.
- One API key and one base URL, simplifying authentication and usage.
- Consistent JSON response structure, making it easy to parse and integrate.
- Global AIS coverage with near real-time refresh rates, ensuring timely data access.
- Scalable solutions suitable for indie developers to enterprise fleets.
- 7-day free trial available for all plans, allowing users to explore the API's capabilities.
Vessel Intelligence Endpoints
The Vessel Intelligence endpoints are designed to provide detailed information about individual vessels, their current positions, and historical data. Here are the key endpoints:
1. Vessel Search
The GET /vessels/search endpoint allows users to find any vessel by name, IMO, or MMSI. This endpoint supports various optional filters, such as ship type, flag, and year built.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=atlantic&flag=Panama"Example Response:
{
"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 companies needing to quickly identify vessels for tracking or 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.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=258785000&hours=48"Example Response:
{
"data": {
"vessel": {
"imo": "258785000",
"mmsi": "258785000",
"name": "Vessel Name",
"current_position": {
"latitude": 34.56,
"longitude": -58.38,
"speed_knots": 12,
"course_degrees": 90,
"heading_degrees": 90,
"navigational_status": "Underway",
"timestamp_utc": "2023-10-01T12:00:00Z",
"destination": "Port Name",
"eta": "2023-10-02T12:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "Port A",
"departure_time": "2023-10-01T10:00:00Z",
"destination_port": "Port B",
"eta": "2023-10-02T12:00:00Z",
"distance_nm": 200,
"avg_speed_knots": 12
},
"last_port_visits": [...]
}
}
}This endpoint is essential for fleet managers who need to monitor vessel movements in real-time, ensuring timely arrivals and optimizing logistics operations.
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.
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:
{
"data": {
"center": {
"latitude": -34.60,
"longitude": -58.38
},
"radius_nm": 30,
"total": 5,
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Vessel A",
"ship_type": "Cargo",
"position": {
"latitude": -34.60,
"longitude": -58.38,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 5,
"speed_knots": 10,
"course_degrees": 180,
"navigational_status": "At Anchor"
}
]
}
}This endpoint helps port authorities manage vessel traffic and optimize docking schedules.
4. Vessel Analytics
The GET /vessels/analytics endpoint provides aggregated voyage statistics, allowing users to analyze performance over different periods.
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:
{
"data": {
"type": "vessel",
"mmsi": "258785000",
"imo": "1234567",
"name": "Vessel Name",
"period": "7d",
"statistics": {
"total_distance_nm": 500,
"avg_speed_knots": 12,
"max_speed_knots": 15,
"port_calls_count": 3,
"total_time_in_port_hours": 10,
"ports_visited": ["Port A", "Port B"]
}
}
}This endpoint is crucial for fleet managers looking to optimize routes and improve operational efficiency.
Fleet Operations Endpoints
The Fleet Operations endpoints enable users to manage multiple vessels simultaneously, providing batch data for enhanced operational oversight.
5. Fleet Management
The POST /vessels/fleet endpoint allows 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}' "https://vessels-api.com/api/V1/vessels/fleet"Example Response:
{
"data": {
"fleet": {
"total_vessels": 2,
"vessels_at_sea": 1,
"vessels_in_port": 1
},
"vessels": [
{
"imo": "9122556",
"mmsi": "309374000",
"name": "Vessel A",
"position": {
"latitude": -34.60,
"longitude": -58.38
},
"route": {
"departure_port": "Port A",
"destination_port": "Port B"
}
}
]
}
}This endpoint is particularly useful for fleet operators who need to monitor multiple vessels and their statuses in real-time.
6. Green Vessel Scoring
The GET /vessels/green endpoint provides IMO CII emissions scoring, 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:
{
"data": {
"imo": "258785000",
"mmsi": "258785000",
"name": "Vessel Name",
"period": "30d",
"distance_nm": 500,
"estimated_emissions": {
"co2_tons": 100,
"co2_per_nm": 0.2
},
"cii": {
"score": "B",
"rating": "Good",
"year": 2023,
"regulation_reference": "IMO MEPC.339(76)"
}
}
}This endpoint is vital for companies aiming to meet environmental standards and improve their sustainability practices.
Port Intelligence Endpoints
The Port Intelligence endpoints provide critical data about port operations, congestion, and vessel activity, enabling better decision-making for port authorities and logistics teams.
7. Port Congestion
The GET /ports/congestion endpoint offers real-time congestion snapshots and wait-time statistics for ports.
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:
{
"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 essential for port operators to manage vessel traffic and optimize berth allocation.
8. Port Catalog
The GET /ports endpoint provides a full catalog of ports, including identifiers, coordinates, and country information.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports"Example Response:
{
"data": {
"ports": [
{
"port_id": "ARBUE",
"name": "Port of Buenos Aires",
"country": "Argentina",
"latitude": -34.60,
"longitude": -58.38,
"timezone": "UTC-3"
}
],
"total": 248
}
}This endpoint is useful for logistics teams to identify and plan for port calls.
9. Port Activity
The GET /port/activity endpoint provides recent arrivals and departures for a specific port, which is crucial for logistics event feeds.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/activity?port=ARBUE"Example Response:
{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"arrivals": [
{
"mmsi": "123456789",
"name": "Vessel A",
"arrival_time": "2023-10-01T12:00:00Z",
"from_port": "Port of Montevideo"
}
],
"departures": [
{
"mmsi": "987654321",
"name": "Vessel B",
"departure_time": "2023-10-01T14:00:00Z",
"to_port": "Port of Santos"
}
]
}
}This endpoint helps logistics teams stay informed about vessel movements, enhancing operational efficiency.
Conclusion
The Vessels API is an indispensable 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—try Vessels API for free today and unlock the potential of real-time maritime data.
Get started with the Vessels API and transform your maritime operations!
