List Vehicle Damages

Retrieve a paginated list of vehicle damage reports across the fleet. Damage tracking is essential for fleet maintenance, insurance claims, and ensuring vehicles remain in good condition for customers.

Damage reports are created when:

• A client reports damage during or after a booking
• Staff identifies damage during vehicle inspection
• Automated systems detect anomalies (e.g., accident detection via telematics)

Each damage report includes:

• Vehicle Information: Which vehicle was damaged
• Booking Context: Related booking when the damage was discovered
• Reporter Details: Who reported the damage (client or staff)
• Damage Details: Type, location on vehicle, severity, and description
• Status: Current state in the resolution workflow

This endpoint helps fleet managers monitor damage trends, prioritize repairs, and maintain fleet quality.

Endpoint

INFO

GET /api/v1/dashboard/damages

Headers

Header	Value	Required
Accept	application/json	Yes
Authorization	Bearer {token}	Yes

Query Parameters

Parameter	Type	Default	Description
vehicle_id	integer	-	Filter by vehicle
status	string	-	Filter: reported, assessing, repairing, resolved
severity	string	-	Filter: minor, moderate, severe
page	integer	1	Page number
per_page	integer	15	Items per page

Example Request

curl -X GET "https://api.daakey.com/api/v1/dashboard/damages?status=reported" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}"

Response

Success (200)

{
  "success": true,
  "message": "Damages retrieved",
  "data": [
    {
      "id": 1,
      "vehicle": {
        "id": 1,
        "plate_number": "ABC-123",
        "brand": "Toyota",
        "model": "Corolla"
      },
      "booking": {
        "id": 50,
        "reference": "BK-2024-00050"
      },
      "reported_by": {
        "id": 10,
        "name": "John Doe",
        "type": "client"
      },
      "type": "scratch",
      "location": "front_bumper",
      "severity": "minor",
      "description": "Small scratch on front bumper",
      "status": "reported",
      "images_count": 2,
      "created_at": "2024-01-15T10:00:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 1,
    "per_page": 15,
    "total": 1
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Damage Status Values

Status	Description
reported	Newly reported damage
assessing	Under assessment
repairing	Being repaired
resolved	Damage resolved