Create a vehicle damage

POST

/fleets/vehicles/{vehicle_id}/damages

Records a damage on the vehicle.

Side effects

When the damage is linked to a reservation, the reservation totals are recalculated, so a damage with charge_in_reservation=true is added to what the customer owes.

The vehicle damage diagram image is regenerated.

Request

Authorization

Path Params

Header Params

Body Params application/jsonRequired

Example

{
    "vehicle_id": 57,
    "damage_type_id": 2,
    "section_id": 4,
    "description": "10 cm scratch on the left side",
    "amount": 150,
    "reservation_id": 1052,
    "charge_in_reservation": true,
    "fixed": false,
    "incident_date_date": "2026-10-05",
    "incident_date_time": "16:30"
}

Responses

🟢200OK

application/json

The saved damage in data. HTTP 200 is also used for failures: always check success. When it is false, the body is an ErrorBusinessRule (status_code 410) or an ErrorUnauthorized (status_code 401 or 403).

Bodyapplication/json

Example

{"success":true,"status_code":200,"errors":[],"data":{"id":88,"label":"Scratch - Front bumper - 10 cm scratch on the left side","reservation_id":1052,"description":"10 cm scratch on the left side","amount":{"currency":"usd","currency_icon":"$","amount":"150.00","usd_amount":"150.00","amount_for_display":"$150.00"},"charge_in_reservation":true,"fixed":false,"section":{"id":4,"name":"Front bumper","price":{"currency":"usd","currency_icon":"$","amount":"120.00","usd_amount":"120.00","amount_for_display":"$120.00"}},"damage_type":{"id":2,"name":"Scratch"},"created_by":"Ana Pérez"}}

🟠404Record Not Found

🟠422Parameter Error

Modified at 2026-10-29 13:52:44

List the damages of a vehicle

Get a vehicle damage