GET /v2/vehicle/{vehicle_id}

Get Vehicle by ID

Returns information for a single vehicle.

Authentication

Send both headers on every request. How auth works →

X-API-Provider-Key Your provider key Identifies your platform. The same for every request.
X-API-Company-Key The carrier's company key Scopes all returned data to that one carrier.

Path parameters

Parameter	Type		Description
`vehicle_id`	UUID	required	The vehicle's unique identifier

Responses

200 OK Success — payload in data, wrapped in the response envelope.

Field	Type	Description
`vehicle_id`	UUID	Unique vehicle identifier
`number`	string	Vehicle or unit number
`vin`	string	Vehicle Identification Number
`active`	boolean	Whether the vehicle is currently active

401 Unauthorized Missing or invalid API key.

Field	Type	Description
`status_code`	integer	HTTP status code (e.g. 401).
`description`	string	Human-readable error message.
`data`	null	Always null on error.

Sample request

curl -X GET "https://api.lucideld.com/v2/vehicle/e5c9f3b1-2d7a-4e8c-a6f3-9b1d4e7c2f5a" \
  -H "X-API-Provider-Key: YOUR_PROVIDER_KEY" \
  -H "X-API-Company-Key: YOUR_COMPANY_KEY"

Example response 200 OK

{
  "description": "success",
  "data": {
    "vehicle_id": "e5c9f3b1-2d7a-4e8c-a6f3-9b1d4e7c2f5a",
    "number": "1042",
    "vin": "1XKYD49X3NJ312847",
    "active": true
  }
}

Error response 401

{
  "status_code": 401,
  "description": "Company API key is not valid",
  "data": null
}