Vehicle Status
Retrieve real-time status and detailed telemetry data for a vehicle during an active booking. This endpoint provides live information from the vehicle's telematics system, including location, fuel level, door status, and connectivity state.
This endpoint is essential for the in-trip experience, allowing the app to display:
- Current vehicle location on a map
- Fuel level to estimate remaining range
- Lock/unlock status for security awareness
- Door status to ensure the vehicle is secured
- Connectivity status to know if commands will work
Access Restriction
Real-time vehicle status is only available to users who have an active booking for the vehicle. This protects user privacy and prevents unauthorized tracking.
Endpoint
INFO
GET /api/v1/client/vehicles/{vehicle}/status
Headers
| Header | Value | Required |
|---|---|---|
Accept | application/json | Yes |
Authorization | Bearer {token} | Yes |
X-Agency-Signature | {signature} | Yes |
Path Parameters
| Parameter | Type | Description |
|---|---|---|
vehicle | integer | Vehicle ID |
Example Request
bash
curl -X GET https://api.daakey.com/api/v1/client/vehicles/1/status \
-H "Accept: application/json" \
-H "Authorization: Bearer {token}" \
-H "X-Agency-Signature: {signature}"Response
Success (200)
json
{
"success": true,
"message": "Vehicle status retrieved",
"data": {
"vehicle_id": 1,
"status": "available",
"location": {
"latitude": 40.7128,
"longitude": -74.0060,
"address": "123 Main St, New York, NY",
"last_update": "2024-01-15T10:00:00Z"
},
"telemetry": {
"fuel_level": 85,
"fuel_type": "petrol",
"mileage": 15420,
"battery_voltage": 12.6,
"is_locked": true,
"is_engine_running": false,
"doors": {
"front_left": "closed",
"front_right": "closed",
"rear_left": "closed",
"rear_right": "closed",
"trunk": "closed"
},
"last_update": "2024-01-15T10:00:00Z"
},
"connectivity": {
"status": "online",
"signal_strength": "strong",
"last_seen": "2024-01-15T10:00:00Z"
}
},
"meta": {
"agency_id": 123,
"agency_code": "AGENCY123"
},
"request_id": "uuid",
"timestamp": "2024-01-01T00:00:00.000Z"
}Error (403)
json
{
"success": false,
"message": "No active booking for this vehicle",
"data": null,
"request_id": "uuid",
"timestamp": "2024-01-01T00:00:00.000Z"
}Notes
- Real-time status requires an active booking
- Telemetry data is updated via INVERS telematics
- Location tracking is only available during active bookings