In the fast-paced world of maritime logistics, having access to real-time data is crucial for effective fleet management, operational efficiency, and compliance with environmental regulations. The Vessels API provides developers, startups, and enterprise teams with a comprehensive REST API that covers a wide range of maritime data needs. With 17 endpoints dedicated to vessel search, live AIS tracking, fleet operations, port intelligence, and IMO CII emissions scoring, this API is designed to empower users with the information they need to make informed decisions.
Why Choose Vessels API?
The Vessels API stands out in the maritime data landscape for several reasons:
- Comprehensive Coverage: With 17 REST endpoints, the API covers everything from vessel search to real-time tracking and emissions scoring.
- Unified Access: One API key and a single base URL simplify the integration process, eliminating the need for OAuth or per-endpoint authentication differences.
- Consistent Response Format: Every response follows a uniform JSON envelope, making it easier for developers to parse and utilize the data.
- Global AIS Coverage: The API offers near real-time refresh rates, ensuring that users have access to the most current data available.
- Scalable Solutions: Whether you are an indie developer or managing an enterprise fleet, the API scales to meet your needs.
- Free Trial: Users can explore the API's capabilities with a 7-day free trial, allowing them to assess its fit for their projects.
Key Features and Endpoints
Let’s dive deeper into the most relevant endpoints of the Vessels API, showcasing their capabilities and practical applications.
Vessel Intelligence
1. Search for Vessels
The GET /vessels/search endpoint allows users to find any vessel by name, IMO, or MMSI. This is particularly useful for logistics companies that need to track specific vessels in their fleet.
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=atlantic&flag=Panama"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": 1,
"total": 1,
"last_page": 1
}
}
}Key fields include:
- imo: International Maritime Organization number, a unique identifier for the vessel.
- mmsi: Maritime Mobile Service Identity, used for communication and tracking.
- name: The vessel's name.
- flag: The country under which the vessel is registered.
- vessel_type: The type of vessel (e.g., cargo, tanker).
- gross_tonnage: The total internal volume of the vessel.
- year_built: The year the vessel was constructed.
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 is essential for fleet managers who need to monitor their vessels in real-time.
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/track?mmsi=258785000&hours=48"Response:
{
"data": {
"vessel": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager"
},
"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": "New York",
"eta": "2023-10-05T08:00:00Z"
},
"position_history": [...],
"route": {
"departure_port": "Los Angeles",
"departure_time": "2023-10-01T08:00:00Z",
"destination_port": "New York",
"eta": "2023-10-05T08:00:00Z",
"distance_nm": 3000,
"avg_speed_knots": 12
},
"last_port_visits": [...]
}
}Key fields include:
- current_position: Contains real-time data about the vessel's location, speed, and navigational status.
- route: Provides details about the vessel's journey, including departure and destination ports, ETA, and distance remaining.
3. Nearby Vessels
The GET /vessels/nearby endpoint returns all vessels within a specified radius of a given latitude and longitude. This is useful for port operators and logistics teams to assess traffic in specific areas.
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:
{
"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-01T12:00:00Z"
},
"distance_nm": 10,
"speed_knots": 12,
"course_degrees": 90,
"navigational_status": "Underway"
}
]
}
}Key fields include:
- total: The total number of vessels found within the specified radius.
- vessels: An array of vessels with their respective details, including position and navigational status.
Fleet Operations
4. Batch Fleet Data
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.
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:
{
"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": "Los Angeles",
"destination_port": "New York"
}
}
]
}
}Key fields include:
- total_vessels: The total number of vessels in the fleet.
- vessels_at_sea: The number of vessels currently at sea.
- vessels_in_port: The number of vessels currently docked at a port.
- vessels: An array containing details about each vessel, including their current position and route.
Port Intelligence
5. Port Congestion
The GET /ports/congestion endpoint provides real-time congestion snapshots and wait-time statistics for a specific port. This is invaluable for port operators and logistics teams to manage traffic effectively.
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/ports/congestion?port_id=ARBUE&period=7d"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": 50
}
}
}Key fields include:
- snapshot: Provides a quick overview of the current state of the port, including the number of vessels in anchorage and at berth.
- statistics: Offers insights into average and maximum wait times, as well as the total number of port calls over the specified period.
6. Port Activity
The GET /port/activity endpoint returns recent arrivals and departures for a specific port, which is essential for logistics event feeds.
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/activity?port=ARBUE"Response:
{
"data": {
"port_id": "ARBUE",
"port_name": "Port of Buenos Aires",
"arrivals": [
{
"mmsi": "258785000",
"name": "Atlantic Voyager",
"arrival_time": "2023-10-01T12:00:00Z",
"from_port": "Los Angeles"
}
],
"departures": [
{
"mmsi": "258785000",
"name": "Atlantic Voyager",
"departure_time": "2023-10-01T14:00:00Z",
"to_port": "New York"
}
]
}
}Key fields include:
- arrivals: An array of vessels that have recently arrived at the port, including their origin and arrival times.
- departures: An array of vessels that have recently departed from the port, including their destination and departure times.
IMO CII Emissions Scoring
7. Emissions Scoring
The GET /vessels/green endpoint provides IMO CII emissions scoring for ESG reporting and regulatory compliance. This is crucial for companies looking to meet environmental standards.
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/green?mmsi=258785000&period=30d"Response:
{
"data": {
"imo": "1234567",
"mmsi": "258785000",
"name": "Atlantic Voyager",
"period": "30d",
"distance_nm": 3000,
"estimated_emissions": {
"co2_tons": 150,
"co2_per_nm": 0.05
},
"cii": {
"score": "B",
"rating": "Good",
"year": 2023,
"regulation_reference": "IMO MEPC.339(76)"
}
}
}Key fields include:
- estimated_emissions: Provides data on CO2 emissions over the specified period, which is essential for compliance reporting.
- cii: Contains the CII score and rating, indicating the vessel's environmental performance.
Conclusion
The Vessels API is an invaluable tool for developers and maritime professionals seeking to leverage real-time data for fleet management, logistics optimization, and compliance with environmental regulations. With its comprehensive set of endpoints, consistent response formats, and global AIS coverage, the API simplifies the complexities of maritime data integration.
Whether you are building a fleet dashboard, optimizing logistics ETAs, or ensuring compliance with ESG standards, the Vessels API provides the data and insights you need to succeed. Try Vessels API for free and discover how it can transform your maritime operations.
Ready to get started? Get started with Vessels API today and unlock the potential of real-time maritime data.
