Skip to main content
GET
/
damages
List Damages
curl --request GET \
  --url https://api.inspecto.com/api/third-party/v1/damages \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "vehicleId": "<string>",
      "vehicle": {},
      "description": "<string>",
      "photoUrl": "<string>",
      "status": "<string>",
      "reportedAt": "<string>",
      "reportedBy": {},
      "assignedTo": {},
      "repairedAt": "<string>",
      "inspection": {}
    }
  ]
}

​
Endpoint

GET /api/third-party/v1/damages

​
Authentication

Requires vehicles:read scope.

​
Query Parameters

​
page
integer
default:"1"
Page number
​
limit
integer
default:"50"
Items per page (max: 100)
​
vehicleId
string
Filter by vehicle ID (UUID)
​
status
string
Filter by status: TO_REPAIR_NOT_OK, TO_REPAIR_WARNING, FIXED, IGNORED, REJECTED
​
assignedToId
string
Filter by assigned mechanic/user ID

​
Response

​
data
array
Array of damage objects

​
Example Request

curl -X GET "https://api.inspecto.com/api/third-party/v1/damages?status=TO_REPAIR_NOT_OK" \
  -H "Authorization: Bearer insp_your_api_key_here"

​
Example Response

{
  "data": [
    {
      "id": "damage-001",
      "vehicleId": "550e8400-e29b-41d4-a716-446655440000",
      "vehicle": {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "plateNumber": "ABC-1234",
        "brand": "Mercedes-Benz",
        "model": "Actros"
      },
      "description": "Broken side mirror",
      "photoUrl": "https://storage.example.com/damage-001.jpg",
      "status": "TO_REPAIR_NOT_OK",
      "reportedAt": "2024-12-09T10:15:00Z",
      "reportedBy": {
        "id": "user-123",
        "firstName": "John",
        "lastName": "Doe"
      },
      "assignedTo": {
        "id": "mechanic-456",
        "firstName": "Mike",
        "lastName": "Smith"
      },
      "repairedAt": null,
      "inspection": {
        "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
        "performedAt": "2024-12-09T10:00:00Z"
      }
    }
  ],
  "meta": {
    "version": "v1",
    "pagination": {
      "currentPage": 1,
      "totalPages": 3,
      "totalCount": 27,
      "hasNextPage": true,
      "hasPreviousPage": false
    }
  }
}