Vehicle Details

Retrieve comprehensive information about a specific vehicle in the agency's fleet. This endpoint returns everything needed to display a vehicle detail page, including specifications, features, pricing, current location, and real-time telemetry data.

Use this endpoint when:

• Displaying a vehicle detail screen before booking
• Showing vehicle specifications and features
• Displaying the vehicle's current location on a map
• Checking real-time status like fuel level and lock state

The response includes telemetry data from the INVERS telematics system, providing real-time information about the vehicle's current state including fuel level, mileage, lock status, and whether the engine is running.

Endpoint

INFO

GET /api/v1/client/vehicles/{id}

Headers

Header	Value	Required
Accept	application/json	Yes
Authorization	Bearer {token}	Yes
X-Agency-Signature	{signature}	Yes

Path Parameters

Parameter	Type	Description
id	integer	Vehicle ID

Example Request

curl -X GET https://api.daakey.com/api/v1/client/vehicles/1 \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}" \
  -H "X-Agency-Signature: {signature}"

Response

Success (200)

{
  "success": true,
  "message": "Vehicle retrieved",
  "data": {
    "id": 1,
    "plate_number": "ABC-123",
    "brand": "Toyota",
    "model": "Corolla",
    "year": 2023,
    "color": "White",
    "category": "sedan",
    "seats": 5,
    "fuel_type": "petrol",
    "transmission": "automatic",
    "images": [
      "https://api.daakey.com/storage/vehicles/1/front.jpg",
      "https://api.daakey.com/storage/vehicles/1/side.jpg"
    ],
    "features": [
      "Air Conditioning",
      "Bluetooth",
      "Backup Camera",
      "GPS Navigation"
    ],
    "pricing": {
      "hourly_rate": 15.00,
      "daily_rate": 80.00,
      "currency": "USD"
    },
    "location": {
      "latitude": 40.7128,
      "longitude": -74.0060,
      "address": "123 Main St, New York, NY"
    },
    "status": "available",
    "telemetry": {
      "fuel_level": 75,
      "mileage": 15000,
      "battery_voltage": 12.6,
      "is_locked": true,
      "is_engine_running": false
    }
  },
  "meta": {
    "agency_id": 123,
    "agency_code": "AGENCY123"
  },
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Error (404)

{
  "success": false,
  "message": "Vehicle not found",
  "data": null,
  "request_id": "uuid",
  "timestamp": "2024-01-01T00:00:00.000Z"
}

Vehicle Status Values

Status	Description
available	Ready for booking
booked	Currently reserved
in_use	Currently being used
maintenance	Under maintenance
unavailable	Not available