Shipwrecked API

Full API Reference

Explore all endpoints for maritime vessel operations, cargo tracking, and real-time fleet analytics.

🚢 Vessels Management

GET /vessels

curl -X GET "https://api.shipwrecked.co/v1/vessels" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json"

Response

[
  {"id": "V12345", "name": "MV Horizon", "location": {"lat": 40.71, "lng": -74.01}},
  {"id": "V67890", "name": "MV Pacifica", "location": {"lat": 34.05, "lng": -118.24}}
]

POST /vessels

curl -X POST "https://api.shipwrecked.co/v1/vessels" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "name": "MV Starlight",
           "imo": "7654321",
           "vessel_type": "container"
         }'

Response

{
  "id": "V78901",
  "status": "created"
}

🚦 Ship Trips

GET /trips

curl -X GET "https://api.shipwrecked.co/v1/trips?status=active" \
     -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "data": [
    {
      "trip_id": "T45678",
      "vessel": "V12345",
      "route": {"from": "Seattle", "to": "Tokyo"},
      "departure_time": "2025-07-01T08:00:00Z"
    }
  ]
}

⛽ Fuel Management

GET /fuel/forecast

curl -X GET "https://api.shipwrecked.co/v1/fuel/forecast?vessel=V12345" \
     -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "vessel": "V12345",
  "forecast": [
    {"day": "2025-08-01", "fuel_required": "25000 liters"},
    {"day": "2025-08-02", "fuel_required": "26500 liters"}
  ]
}