Get details of a specific vehicle
GET/company/vehicles/:id
Retrieves complete details of a specific vehicle from the company's fleet.
Objective
Enable companies to view full information about a single vehicle including all metadata, file references, and calculated cargo capacity.
Use Cases
- View complete vehicle details before editing
- Display vehicle information in detail view
- Retrieve image and ITV certificate URLs
- Access calculated cargo capacity ranges
Security
This endpoint validates ownership - the vehicle must belong to the authenticated user's company. If the vehicle exists but belongs to another company, returns 403 CIA_NOT_OWNER.
Image URLs
URLs for images and ITV certificates follow the format /images?file={s3_key}.
Access these URLs with authentication to retrieve the actual files.
Calculated Fields
The cargo field is automatically calculated based on vehicle_type and contains
volume (m³) and weight (kg) capacity ranges.
Request
Responses
- 200
- 400
- 401
- 403
- 404
Vehicle details retrieved successfully
Response Headers
General error retrieving vehicle
User does not have an associated company.
Forbidden. The vehicle exists but does not belong to the authenticated user's company. This is a security error indicating the user is attempting to access a resource that does not belong to them.
Vehicle not found