Containership Tracking API: Real-Time Maritime Data & Analytics

Containership Tracking API: Real-Time Maritime Data & Analytics

Introduction

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 offers a comprehensive REST API that provides developers, startups, and enterprise teams with instant access to global maritime vessel tracking data powered by AIS (Automatic Identification System). With 17 robust endpoints, the Vessels API covers everything from vessel search and live tracking to fleet operations, port intelligence, and IMO CII emissions scoring. This blog post will delve into the capabilities of the Vessels API, showcasing how it can transform maritime operations and provide significant value to various stakeholders in the industry.

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, eliminating the complexity of OAuth and per-endpoint authentication differences.
  • Consistent JSON envelope on every response, ensuring a uniform structure: {status, success, message, data}.
  • Global AIS coverage with near real-time refresh rates, providing timely and accurate data.
  • Scalable solutions suitable for indie developers, logistics startups, fleet managers, and port operators.
  • 7-day free trial available on all plans, allowing users to explore the API's capabilities without commitment.

Key Endpoints for Containership Tracking

For developers looking to implement containership tracking solutions, the following endpoints are particularly relevant:

  • GET /vessels/search: Find any vessel by name, IMO, or MMSI with optional filters.
  • GET /vessels/track: Retrieve live position, position history, active route, predicted ETA, and weather data.
  • GET /vessels/nearby: Get all vessels within a specified radius of a given latitude and longitude.
  • GET /vessels/analytics: Access aggregated voyage statistics for vessels, ports, or fleets.
  • POST /vessels/fleet: Batch positions, routes, and statistics for multiple vessels in one request.
  • GET /vessels/green: Obtain IMO CII emissions scoring for ESG reporting and regulatory compliance.

Vessel Search Endpoint

The GET /vessels/search endpoint allows users to find vessels by various identifiers, including name, IMO, or MMSI. This is particularly useful for logistics companies needing to track specific vessels in their fleet.

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": "Containership",
"gross_tonnage": 50000,
"deadweight_tonnage": 60000,
"year_built": 2010,
"length_m": 300,
"width_m": 40
}
],
"pagination": {
"current_page": 1,
"per_page": 1,
"total": 1,
"last_page": 1
}
}
}

In this response, key fields include:

  • imo: The International Maritime Organization number, a unique identifier for the vessel.
  • mmsi: The Maritime Mobile Service Identity, another unique identifier.
  • name: The name of the vessel.
  • flag: The country under which the vessel is registered.
  • vessel_type: The type of vessel, in this case, a containership.
  • gross_tonnage and deadweight_tonnage: Important metrics for understanding the vessel's capacity.
  • year_built: The year the vessel was constructed, which can impact its operational efficiency.
  • length_m and width_m: Dimensions that are crucial for port operations and logistics planning.

Live Vessel Tracking

The GET /vessels/track endpoint provides real-time tracking information, including the current position, historical data, active routes, and predicted ETAs. This is essential for fleet managers and logistics coordinators who need to monitor vessel movements closely.

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": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager"
},
"current_position": {
"latitude": 34.0522,
"longitude": -118.2437,
"speed_knots": 15,
"course_degrees": 90,
"heading_degrees": 90,
"navigational_status": "Underway",
"timestamp_utc": "2023-10-01T12:00:00Z",
"destination": "Los Angeles",
"eta": "2023-10-02T08:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "Seattle",
"departure_time": "2023-10-01T08:00:00Z",
"destination_port": "Los Angeles",
"eta": "2023-10-02T08:00:00Z",
"distance_nm": 100,
"avg_speed_knots": 15
},
"last_port_visits": [...]
}
}

Key fields in this response include:

  • current_position: Contains real-time data such as latitude, longitude, speed, and navigational status.
  • timestamp_utc: The time at which the position was recorded, crucial for tracking movements accurately.
  • destination and eta: Essential for logistics planning and customer communication.
  • route: Provides details about the vessel's journey, including departure and destination ports, which are vital for operational efficiency.

Nearby Vessels

The GET /vessels/nearby endpoint allows users to find all vessels within a specified radius of a given latitude and longitude. This is particularly useful for port operators and logistics teams needing to assess vessel traffic in real-time.

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": "258785000",
"name": "Atlantic Voyager",
"ship_type": "Containership",
"position": {
"latitude": -34.60,
"longitude": -58.38,
"timestamp_utc": "2023-10-01T12:00:00Z"
},
"distance_nm": 10,
"speed_knots": 15,
"course_degrees": 90,
"navigational_status": "Underway"
}
]
}
}

Key fields in this response include:

  • total: The total number of vessels found within the specified radius.
  • vessels: An array containing details about each vessel, including its current position and navigational status.
  • distance_nm: The distance from the specified point to the vessel, which is crucial for operational planning.

Aggregated Voyage Statistics

The GET /vessels/analytics endpoint provides aggregated voyage statistics, allowing users to analyze performance over different periods. This is invaluable for fleet managers looking to optimize routes and improve 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:

{
"data": {
"type": "vessel",
"mmsi": "258785000",
"imo": "1234567",
"name": "Atlantic Voyager",
"period": "7d",
"statistics": {
"total_distance_nm": 500,
"avg_speed_knots": 15,
"max_speed_knots": 20,
"port_calls_count": 3,
"total_time_in_port_hours": 10,
"ports_visited": ["Seattle", "Los Angeles"]
}
}
}

Key fields in this response include:

  • total_distance_nm: The total distance traveled by the vessel, which is essential for fuel consumption analysis.
  • avg_speed_knots and max_speed_knots: Important metrics for assessing operational efficiency.
  • port_calls_count: The number of times the vessel has called at ports, which can impact scheduling and logistics.
  • total_time_in_port_hours: Useful for understanding turnaround times and optimizing port operations.
  • ports_visited: A list of ports the vessel has visited, which can aid in route planning and compliance reporting.

Batch Operations for Fleet Management

The POST /vessels/fleet endpoint allows users to retrieve batch positions, routes, and statistics for multiple vessels in a single request. This is particularly beneficial for fleet managers who need to monitor several vessels simultaneously.

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": "Atlantic Voyager",
"position": {
"latitude": 34.0522,
"longitude": -118.2437
},
"route": {
"departure_port": "Seattle",
"destination_port": "Los Angeles"
}
}
]
}
}

Key fields in this response include:

  • total_vessels: The total number of vessels in the fleet.
  • vessels_at_sea and vessels_in_port: Metrics that help fleet managers understand their operational status.
  • position: Provides real-time location data for each vessel, essential for tracking and logistics.
  • route: Details about the vessel's journey, which can aid in operational planning and customer communication.

IMO CII Emissions Scoring

The GET /vessels/green endpoint provides IMO CII emissions scoring, which is crucial for ESG reporting and regulatory compliance. This is increasingly important as the maritime industry faces pressure to reduce emissions and improve sustainability.

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": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"period": "30d",
"distance_nm": 500,
"estimated_emissions": {
"co2_tons": 50,
"co2_per_nm": 0.1
},
"cii": {
"score": "B",
"rating": "Good",
"year": 2023,
"regulation_reference": "IMO MEPC.339(76)"
}
}
}

Key fields in this response include:

  • estimated_emissions: Provides insights into the vessel's carbon footprint, which is essential for compliance and sustainability reporting.
  • cii: The CII score and rating, which indicate the vessel's performance in terms of emissions.
  • regulation_reference: Important for understanding the regulatory framework governing emissions.

Conclusion

The Vessels API is an invaluable tool for developers and organizations in the maritime industry, providing comprehensive access to real-time vessel tracking data and analytics. With its robust set of endpoints, the API enables users to optimize fleet operations, enhance logistics planning, and ensure compliance with environmental regulations. Whether you are a fleet manager, logistics coordinator, or part of an ESG team, the Vessels API offers the data and insights needed to drive efficiency and sustainability in maritime operations.

Ready to transform your maritime operations? Try Vessels API for free and discover how our powerful endpoints can enhance your vessel tracking and analytics capabilities. Get started with Vessels API today!

Keywords
containership tracking API real-time maritime data vessel tracking API maritime logistics solutions API for shipping analytics

Ready to get started?

Get your API key and start tracking vessels in minutes.

Get API Key

Related posts