Shipyard Vessel Tracking API: Real-Time Maritime Data & Analytics

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 through 17 endpoints. This blog post will delve into the capabilities of the Vessels API, focusing on its vessel tracking features, fleet operations, port intelligence, and emissions scoring, all designed to meet the needs of modern maritime operations.

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 IMO CII emissions scoring.
One API key and one base URL, simplifying authentication and usage.
Consistent JSON envelope on every response: {status, success, message, data}.
Global AIS coverage with near real-time refresh rates.
7-day free trial on all plans, making it accessible for indie developers and enterprise fleets alike.

With a focus on developers, logistics startups, fleet managers, port operators, and ESG/compliance teams, the Vessels API is designed to be the go-to solution for maritime data needs.

Vessel Intelligence Endpoints

The Vessels API offers several endpoints dedicated to vessel intelligence, enabling users to search for vessels, track their movements, and analyze their performance. Below, we explore the most relevant endpoints in detail.

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 dimensions, 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:

{
"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 companies needing to identify vessels quickly for operational planning and compliance checks.

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 data is invaluable for fleet managers and logistics coordinators.

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": "2587850",
"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 of Call",
"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": 100,
"avg_speed_knots": 12
},
"last_port_visits": [...]
}
}
}

This endpoint is crucial for real-time decision-making, allowing logistics teams to adjust plans based on current vessel positions and estimated arrival times.

3. Nearby Vessels

The GET /vessels/nearby endpoint retrieves all vessels within a specified radius of a given latitude and longitude. This feature is particularly useful for port operators and logistics teams monitoring vessel traffic in specific areas.

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.61,
"longitude": -58.39,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 1.5,
"speed_knots": 10,
"course_degrees": 180,
"navigational_status": "At Anchor"
}
]
}
}

This endpoint enhances situational awareness for port operations, enabling teams to manage incoming and outgoing vessels effectively.

4. Vessel Analytics

The GET /vessels/analytics endpoint provides aggregated voyage statistics, allowing users to analyze vessel performance over specified periods. This data is essential for fleet managers looking to optimize operations and reduce costs.

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": "2587850",
"name": "Vessel Name",
"period": "7d",
"statistics": {
"total_distance_nm": 500,
"avg_speed_knots": 10,
"max_speed_knots": 15,
"port_calls_count": 3,
"total_time_in_port_hours": 12,
"ports_visited": ["Port A", "Port B"]
}
}
}

This endpoint is invaluable for performance analysis, helping fleet managers identify trends and make data-driven decisions.

Fleet Operations

The Vessels API also offers robust endpoints for fleet operations, enabling users to manage multiple vessels efficiently.

5. Fleet Management

The POST /vessels/fleet endpoint allows users to retrieve batch positions, routes, and statistics for multiple vessels in a single request. This feature is particularly beneficial for large fleets, simplifying data retrieval and analysis.

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 streamlines fleet management, allowing operators to monitor multiple vessels simultaneously and make informed decisions based on real-time data.

Port Intelligence

Understanding port operations is critical for optimizing logistics and ensuring timely deliveries. The Vessels API provides several endpoints dedicated to port intelligence.

6. Port Congestion

The GET /ports/congestion endpoint offers real-time snapshots of port congestion and wait-time statistics, enabling logistics teams to plan accordingly.

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": 10
}
}
}

This endpoint is essential for port operators and logistics teams, helping them manage vessel arrivals and optimize berth assignments.

7. Expected Arrivals

The GET /port/expected-arrivals endpoint provides information on vessels expected to arrive at a specific port, including their ETA and origin. This data is crucial for 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:

{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"expected_arrivals": [
{
"mmsi": "258785000",
"imo": "2587850",
"name": "Vessel Name",
"vessel_type": "Cargo",
"eta": "2023-10-02T12:00:00Z",
"departure_port": "Port A"
}
],
"total": 1
}
}

This endpoint enhances operational efficiency by providing advance notice of incoming vessels, allowing for better resource management.

IMO CII Emissions Scoring

With increasing regulatory scrutiny on emissions, the Vessels API offers endpoints for tracking vessel emissions and compliance with environmental standards.

8. Green Vessel 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:

{
"data": {
"imo": "2587850",
"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.

Conclusion

The Vessels API is a comprehensive solution for accessing real-time maritime data and analytics. With its extensive range of endpoints covering vessel tracking, fleet operations, port intelligence, and emissions scoring, it empowers developers and businesses to optimize their maritime operations effectively.

Whether you are a fleet manager looking to enhance operational efficiency, a logistics startup aiming to improve ETAs, or an ESG team focused on compliance, the Vessels API provides the tools you need to succeed.

Don't miss out on the opportunity to leverage real-time maritime data. Get started with Vessels API today and transform your maritime operations!

For more information and to explore the full capabilities of the API, Try Vessels API for free and see how it can benefit your business.