Skip to main content
GET
/
inspections
List Inspections
curl --request GET \
  --url https://api.inspecto.com/api/third-party/v1/inspections \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "templateId": "<string>",
      "template": {},
      "status": "<string>",
      "performedAt": "<string>",
      "performedBy": {},
      "vehicles": [
        {}
      ],
      "location": {},
      "notes": "<string>",
      "responseCount": 123,
      "damageCount": 123,
      "damages": [
        {}
      ]
    }
  ]
}

​
Endpoint

GET /api/third-party/v1/inspections

​
Authentication

Requires inspections: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)
​
templateId
string
Filter by inspection template ID (UUID)
​
status
string
Filter by status: COMPLETED, PENDING_REVIEW, REQUIRES_ATTENTION
​
performedById
string
Filter by user who performed the inspection
​
fromDate
string
Filter inspections from this date (ISO 8601)
​
toDate
string
Filter inspections until this date (ISO 8601)

​
Response

​
data
array
Array of inspection objects

​
Example Request

curl -X GET "https://api.inspecto.com/api/third-party/v1/inspections?status=COMPLETED&fromDate=2024-12-01" \
  -H "Authorization: Bearer insp_your_api_key_here"

​
Example Response

{
  "data": [
    {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "templateId": "a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
      "template": {
        "id": "a1b2c3d4-e5f6-4a5b-8c9d-0e1f2a3b4c5d",
        "title": "Pre-Trip Inspection",
        "version": 2
      },
      "status": "COMPLETED",
      "performedAt": "2024-12-09T08:30:00Z",
      "performedBy": {
        "id": "user-123",
        "firstName": "John",
        "lastName": "Doe"
      },
      "vehicles": [
        {
          "id": "550e8400-e29b-41d4-a716-446655440000",
          "plateNumber": "ABC-1234",
          "brand": "Mercedes-Benz",
          "model": "Actros"
        }
      ],
      "location": {
        "title": "Warsaw Depot",
        "latitude": 52.2297,
        "longitude": 21.0122
      },
      "notes": "All checks passed",
      "responseCount": 15,
      "damageCount": 1,
      "damages": [
        {
          "id": "damage-001",
          "description": "Minor scratch",
          "status": "TO_REPAIR_WARNING",
          "photoUrl": "https://..."
        }
      ]
    }
  ],
  "meta": {
    "version": "v1",
    "pagination": {
      "currentPage": 1,
      "totalPages": 5,
      "totalCount": 237,
      "hasNextPage": true,
      "hasPreviousPage": false
    }
  }
}