Introduction
In the maritime industry, real-time data and analytics are crucial for effective decision-making and operational efficiency. Fireboats, essential for firefighting and rescue operations at sea, require precise tracking and monitoring to ensure they can respond swiftly to emergencies. The Vessels API provides a comprehensive solution for developers, startups, and enterprise teams looking to access global maritime vessel tracking data powered by AIS (Automatic Identification System). With 17 REST endpoints, including vessel search, live tracking, fleet operations, port intelligence, and emissions scoring, the Vessels API is the go-to maritime data API for all your needs.
Why Choose Vessels API?
The Vessels API stands out for several reasons:
- 18 REST endpoints covering a wide range of maritime data.
- One API key and one base URL for simplified access.
- Consistent JSON envelope on every response: {status, success, message, data}.
- Global AIS coverage with near real-time refresh rates.
- 7-day free trial available for all plans, making it accessible for indie developers and enterprise fleets alike.
Key Features of the Vessels API
Vessel Intelligence
The Vessels API provides extensive vessel intelligence through its various endpoints. Here are some of the most relevant endpoints for fireboat tracking:
1. Vessel Search
The GET /vessels/search endpoint allows users to find any vessel by name, IMO, or MMSI. This is particularly useful for locating fireboats quickly.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/search?query=fireboat&flag=USA"Example Response:
{
"status": 200,
"success": true,
"message": "Vessels found",
"data": {
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Fireboat 1",
"flag": "USA",
"vessel_type": "Fireboat",
"gross_tonnage": 500,
"deadweight_tonnage": 300,
"year_built": 2010,
"length_m": 30,
"width_m": 10
}
],
"pagination": {
"current_page": 1,
"per_page": 10,
"total": 1,
"last_page": 1
}
}
}This endpoint is invaluable for fleet managers and port operators who need to quickly identify fireboats in their vicinity.
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=123456789&hours=48"Example Response:
{
"status": 200,
"success": true,
"message": "Vessel tracking data retrieved",
"data": {
"vessel": {
"imo": "1234567",
"mmsi": "123456789",
"name": "Fireboat 1"
},
"current_position": {
"latitude": 34.0522,
"longitude": -118.2437,
"speed_knots": 12,
"course_degrees": 90,
"heading_degrees": 90,
"navigational_status": "Under way using engine",
"timestamp_utc": "2023-10-13T10:36:00Z",
"destination": "Los Angeles Port",
"eta": "2023-10-13T12:00:00Z"
},
"position_history": [
{
"timestamp": "2023-10-12T10:36:00Z",
"latitude": 34.0520,
"longitude": -118.2430
}
],
"route": {
"departure_port": "San Francisco",
"departure_time": "2023-10-12T08:00:00Z",
"destination_port": "Los Angeles",
"eta": "2023-10-13T12:00:00Z",
"distance_nm": 300,
"avg_speed_knots": 12
},
"last_port_visits": [
{
"port_name": "San Francisco",
"arrival_time": "2023-10-12T08:00:00Z",
"departure_time": "2023-10-12T10:00:00Z"
}
]
}
}This endpoint is crucial for logistics teams and fleet managers who need to monitor the real-time status of fireboats, ensuring they can respond to emergencies promptly.
3. 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 fireboat operations in emergency situations.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/vessels/nearby?latitude=34.0522&longitude=-118.2437&radius=30"Example Response:
{
"status": 200,
"success": true,
"message": "Nearby vessels retrieved",
"data": {
"center": {
"latitude": 34.0522,
"longitude": -118.2437
},
"radius_nm": 30,
"total": 5,
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Fireboat 1",
"ship_type": "Fireboat",
"position": {
"latitude": 34.0522,
"longitude": -118.2437,
"timestamp_utc": "2023-10-13T10:36:00Z"
},
"distance_nm": 0,
"speed_knots": 12,
"course_degrees": 90,
"navigational_status": "Under way using engine"
}
]
}
}This endpoint is essential for emergency response teams to quickly locate nearby fireboats during critical situations.
Fleet Operations
Managing a fleet of fireboats requires efficient tracking and operational insights. The Vessels API provides endpoints that facilitate fleet operations:
4. Fleet Data
The POST /vessels/fleet endpoint allows users to batch request positions, routes, and statistics for multiple vessels in one request. This is particularly useful for fleet managers overseeing several fireboats.
Example Request:
curl -X POST -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" -d '{"vessels":[{"imo":"1234567"},{"mmsi":"123456789"}],"include_positions":true,"include_routes":true}' "https://vessels-api.com/api/V1/vessels/fleet"Example Response:
{
"status": 200,
"success": true,
"message": "Fleet data retrieved",
"data": {
"fleet": {
"total_vessels": 2,
"vessels_at_sea": 1,
"vessels_in_port": 1
},
"vessels": [
{
"imo": "1234567",
"mmsi": "123456789",
"name": "Fireboat 1",
"position": {
"latitude": 34.0522,
"longitude": -118.2437
},
"route": {
"departure_port": "San Francisco",
"destination_port": "Los Angeles"
}
}
]
}
}This endpoint streamlines fleet management by providing a comprehensive overview of all vessels, their current status, and routes.
Port Intelligence
Understanding port operations is vital for fireboat management. The Vessels API offers several endpoints that provide insights into port conditions:
5. Port Congestion
The GET /ports/congestion endpoint provides real-time congestion snapshots and wait-time statistics for a specific port. This information is crucial for fireboats needing to navigate busy 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:
{
"status": 200,
"success": true,
"message": "Congestion data retrieved",
"data": {
"port_id": "ARBUE",
"port_name": "Port of Arbue",
"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": 4,
"port_calls_count": 20
}
}
}This endpoint helps fireboat operators plan their arrivals and departures, ensuring they can navigate busy ports efficiently.
6. 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 is essential for fireboat operations that may need to coordinate with incoming vessels.
Example Request:
curl -H "X-API-Key: YOUR_API_KEY" "https://vessels-api.com/api/V1/port/expected-arrivals?port=ARBUE"Example Response:
{
"status": 200,
"success": true,
"message": "Expected arrivals retrieved",
"data": {
"port_id": "ARBUE",
"port_name": "Port of Arbue",
"expected_arrivals": [
{
"mmsi": "123456789",
"imo": "1234567",
"name": "Fireboat 1",
"vessel_type": "Fireboat",
"eta": "2023-10-13T12:00:00Z",
"departure_port": "San Francisco"
}
],
"total": 1
}
}This endpoint allows fireboat operators to anticipate incoming traffic and adjust their operations accordingly.
Environmental Compliance
With increasing regulations on emissions, the Vessels API also provides endpoints for tracking environmental compliance:
7. IMO CII Emissions 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=123456789&period=30d"Example Response:
{
"status": 200,
"success": true,
"message": "Emissions data retrieved",
"data": {
"imo": "1234567",
"mmsi": "123456789",
"name": "Fireboat 1",
"period": "30d",
"distance_nm": 500,
"estimated_emissions": {
"co2_tons": 10,
"co2_per_nm": 0.02
},
"cii": {
"score": "B",
"rating": "Good",
"year": 2023,
"regulation_reference": "IMO MEPC.339(76)"
}
}
}This endpoint is crucial for fireboat operators to ensure compliance with environmental regulations and to report their emissions accurately.
Conclusion
The Vessels API is an indispensable tool for developers and maritime professionals looking to enhance their applications with real-time maritime data and analytics. With endpoints covering vessel intelligence, fleet operations, port intelligence, and environmental compliance, the Vessels API provides a comprehensive solution for tracking fireboats and optimizing maritime operations.
Whether you are a fleet manager, logistics startup, or port operator, the Vessels API can help you make informed decisions, improve operational efficiency, and ensure compliance with regulations. Try Vessels API for free and discover how it can transform your maritime operations today!
For more information and to get started, visit Vessels API.
