Shipwrecked API

Maintenance Management

Schedule and track required vessel maintenance, access historical records, and receive preventive maintenance alerts.

🔧 Maintain Fleet Reliability

92%

Reduced equipment failure

73%

Fewer unplanned downtimes

72

Maintenance types supported

1️⃣ Schedule New Maintenance

POST /maintenance

curl -X POST "https://api.shipwrecked.co/v1/maintenance" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "vessel_id": "V12345",
           "type": "engine_inspection",
           "scheduled_date": "2025-09-01T09:00:00Z"
         }'

Sample Response

{
  "maintenance_id": "M56789",
  "status": "scheduled",
  "technician_notes": []
}

2️⃣ View Scheduled Maintenance

GET /maintenance/vessel/{vessel_id}

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

Sample Response

{
  "vessel_id": "V12345",
  "scheduled_maintenance": [
    {
      "maintenance_id": "M56789",
      "type": "engine_inspection",
      "scheduled_date": "2025-09-01T09:00:00Z",
      "status": "scheduled"
    }
  ]
}

3️⃣ Modify Scheduled Maintenance

PATCH /maintenance/{maintenance_id}

curl -X PATCH "https://api.shipwrecked.co/v1/maintenance/M56789" \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
           "scheduled_date": "2025-09-01T15:00:00Z"
         }'

Sample Response

{
  "maintenance_id": "M56789",
  "status": "rescheduled",
  "scheduled_date": "2025-09-01T15:00:00Z"
}

4️⃣ Maintenance History

GET /maintenance/history

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

Sample Response

{
  "vessel_id": "V12345",
  "history": [
    {
      "maintenance_id": "M56788",
      "type": "engine_inspection", 
      "date_completed": "2025-08-01T11:30:00Z",
      "technician_notes": "Routine inspection completed"
    }
  ]
}

5️⃣ Maintenance Alerts

PUT /maintenance/alerts

curl -X PUT "https://api.shipwrecked.co/v1/maintenance/alerts" \
     -H "Authorization: Bearer YOUR_API_key" \
     -H "Content-Type: application/json" \
     -d '{
           "vessel": "V12345",
           "type": "exhaust_overpressure",
           "threshold": 85,
           "alert_duration_hours": 24
         }'

Sample Response

{
  "vessel": "V12345",
  "alert_active": false,
  "threshold": 85,
  "alert_duration_hours": 24
}