Create Damage Report

Create a new vehicle damage report.

Endpoint

INFO

POST /api/v1/dashboard/damages

Headers

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

Request Body

Parameter	Type	Required	Description
vehicle_id	integer	Yes	Vehicle ID
booking_id	integer	No	Related booking ID
type	string	Yes	Damage type
location	string	Yes	Damage location on vehicle
severity	string	Yes	Severity: minor, moderate, severe
description	string	Yes	Detailed description
images	array	No	Array of image URLs

Example Request

curl -X POST https://api.daakey.com/api/v1/dashboard/damages \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -d '{
    "vehicle_id": 1,
    "booking_id": 50,
    "type": "scratch",
    "location": "front_bumper",
    "severity": "minor",
    "description": "Small scratch on front bumper, approximately 5cm long"
  }'

Response

Success (201)

{
  "success": true,
  "message": "Damage report created",
  "data": {
    "id": 1,
    "vehicle": {
      "id": 1,
      "plate_number": "ABC-123"
    },
    "booking": {
      "id": 50,
      "reference": "BK-2024-00050"
    },
    "type": "scratch",
    "location": "front_bumper",
    "severity": "minor",
    "description": "Small scratch on front bumper, approximately 5cm long",
    "status": "reported",
    "created_at": "2024-01-15T10:00:00Z"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Damage Types

Type	Description
scratch	Surface scratches
dent	Dents or deformations
crack	Cracks (windshield, lights)
stain	Interior stains
mechanical	Mechanical issues
other	Other damage types

Location Values

Location	Description
front_bumper	Front bumper
rear_bumper	Rear bumper
hood	Hood/bonnet
roof	Roof
door_front_left	Front left door
door_front_right	Front right door
door_rear_left	Rear left door
door_rear_right	Rear right door
fender_front_left	Front left fender
fender_front_right	Front right fender
fender_rear_left	Rear left fender
fender_rear_right	Rear right fender
interior	Interior
windshield	Windshield
window	Windows
tire	Tires/wheels