Skip to main content
GET
/
vehicle-fields
/
{id}
/
vehicles
List Vehicles For Field
curl --request GET \
  --url https://api.inspecto.com/api/third-party/v1/vehicle-fields/{id}/vehicles \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "vehicleId": "<string>",
      "plateNumber": "<string>",
      "brand": "<string>",
      "model": "<string>",
      "status": "<string>",
      "latestResponse": {}
    }
  ]
}

​
Endpoint

GET /api/third-party/v1/vehicle-fields/{id}/vehicles

​
Authentication

Requires vehicle-fields:read.

​
Use Case

Use this endpoint when you need answers like:
  • “Show every vehicle whose Dokumenty field is currently WARNING.”
  • “Return all vehicles that have any derived status for this custom field.”
The endpoint deduplicates by vehicle and returns the latest response per vehicle for the selected field.

​
Query Parameters

​
id
string
required
Vehicle field identifier
​
page
integer
default:"1"
Page number to retrieve
​
limit
integer
default:"50"
Number of vehicles per page (max: 100)
​
status
string
Filter by derived field status: OK, WARNING, NOT_OK
​
search
string
Search by plate number, brand, or model

​
Response

​
data
array
Vehicles matched to the field

​
Example Request

curl -X GET "https://api.inspecto.com/api/third-party/v1/vehicle-fields/field-docs/vehicles?status=WARNING" \
  -H "Authorization: Bearer insp_your_api_key_here"

​
Example Response

{
  "data": [
    {
      "vehicleId": "vehicle-1",
      "plateNumber": "PO12345",
      "brand": "Volvo",
      "model": "FH",
      "status": "WARNING",
      "latestResponse": {
        "id": "response-44",
        "inspectionId": "inspection-91",
        "value": "missing",
        "fileUrl": null,
        "updatedAt": "2026-04-20T10:00:00.000Z"
      }
    }
  ],
  "meta": {
    "version": "v1",
    "field": {
      "id": "field-docs",
      "label": "Dokumenty",
      "inputType": "SELECT"
    },
    "pagination": {
      "currentPage": 1,
      "totalPages": 1,
      "totalCount": 1,
      "hasNextPage": false,
      "hasPreviousPage": false
    },
    "filters": {
      "search": null,
      "status": "WARNING"
    }
  }
}