Skip to main content
GET
/
vehicles
/
{id}
Get Vehicle
curl --request GET \
  --url https://api.inspecto.com/api/third-party/v1/vehicles/{id} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "<string>",
    "plateNumber": "<string>",
    "vin": "<string>",
    "brand": "<string>",
    "model": "<string>",
    "type": "<string>",
    "status": "<string>",
    "fuelType": "<string>",
    "euroClass": "<string>",
    "capacity": 123,
    "fuel": 123,
    "lastMaintenance": "<string>",
    "updatedAt": "<string>",
    "lastInspection": {
      "id": "<string>",
      "performedAt": "<string>",
      "status": "<string>"
    }
  },
  "meta": {}
}

​
Endpoint

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

​
Authentication

Requires vehicles:read scope.

​
Path Parameters

​
id
string
required
Vehicle ID (UUID)

​
Response

​
data
object
Vehicle object with additional details
​
meta
object
Response metadata

​
Example Request

curl -X GET "https://api.inspecto.com/api/third-party/v1/vehicles/550e8400-e29b-41d4-a716-446655440000" \
  -H "Authorization: Bearer insp_your_api_key_here"

​
Example Response

{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "plateNumber": "ABC-1234",
    "vin": "WDB9634321L123456",
    "brand": "Mercedes-Benz",
    "model": "Actros",
    "type": "TRACTOR_UNIT",
    "status": "OK",
    "fuelType": "DIESEL",
    "euroClass": "EURO_6",
    "capacity": 18.5,
    "fuel": 450.0,
    "lastMaintenance": "2024-11-15T10:30:00Z",
    "updatedAt": "2024-12-09T14:22:00Z",
    "lastInspection": {
      "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "performedAt": "2024-12-08T09:15:00Z",
      "status": "COMPLETED"
    }
  },
  "meta": {
    "version": "v1"
  }
}

​
Error Responses

{
  "errors": [{
    "code": "NOT_FOUND",
    "message": "Vehicle not found"
  }]
}
Causes:
  • Vehicle ID doesn’t exist
  • Vehicle doesn’t belong to your company
  • Vehicle has been deleted