Vehicle Control (Admin)

Remotely control and monitor any vehicle in your fleet via its telematics unit. The Admin API exposes the full set of commands and telemetry signals supported by the platform.

Capabilities

Every vehicle connected to Daakey supports the following capabilities. Individual signal availability depends on the OEM and telematics provider integrated with the specific vehicle — the platform exposes whatever the vehicle reports.

Control commands

Capability	Description
Lock / Unlock	Lock or unlock all doors
Enable / Disable driving	Engage or disengage the engine immobilizer
Unlock + enable driving	Combined handover command
Lock + disable driving	Combined return command
Remote attention signals	Trigger the horn and / or flash the lights
Top case / battery compartment	Open the top case or battery compartment (where supported)

Live state & telemetry

Signal	Description
Vehicle state on demand	Pull the full current state snapshot at any time
Location & GPS position	Real-time latitude / longitude
Mileage / odometer	Current odometer reading
Speed & heading	Live speed and direction of travel
Ignition status	On / off
Gear position	P / R / N / D (where supported)
Parking brake status	Engaged / released
Battery charge or fuel level	Remaining fuel or battery percentage
Remaining range	Estimated distance to empty
Charging status	Charging / disconnected / fault (EVs only)
Doors, windows, sunroof, seatbelts	Per-opening status (if reported by the OEM)
Vehicle key status	Whether the key is in or out of the vehicle
Onboard voltage	12V auxiliary battery voltage
Telematics health	Connectivity, last seen, signal quality

Diagnostics & maintenance

Signal	Description
Diagnostic trouble codes (DTCs)	Active fault codes from the vehicle
Service & maintenance indicators	Next service due, oil life, warning lamps
Firmware version	Current telematics unit firmware
OEM / telematics-specific data	Additional manufacturer-specific signals

INFO

All control actions and telemetry pulls are recorded in the activity history.

---

Control endpoints

Lock vehicle

INFO

POST /api/v1/admin/vehicles/{vehicle}/control/lock

curl -X POST https://api.daakey.com/api/v1/admin/vehicles/1/control/lock \
  -H "Accept: application/json" \
  -H "Authorization: Bearer {token}"

Unlock vehicle

INFO

POST /api/v1/admin/vehicles/{vehicle}/control/unlock

Enable driving

Engage the engine immobilizer release (allows the vehicle to start).

INFO

POST /api/v1/admin/vehicles/{vehicle}/control/enable-driving

Disable driving

Disengage the engine immobilizer release (prevents restart).

INFO

POST /api/v1/admin/vehicles/{vehicle}/control/disable-driving

Unlock and enable driving

Combined handover command.

INFO

POST /api/v1/admin/vehicles/{vehicle}/control/unlock-and-enable-driving

Lock and disable driving

Combined return command.

INFO

POST /api/v1/admin/vehicles/{vehicle}/control/lock-and-disable-driving

Remote attention signals

Trigger the horn and / or flash the lights to help the driver locate the vehicle.

INFO

POST /api/v1/admin/vehicles/{vehicle}/control/attention

Parameter	Type	Required	Description
signal	string	Yes	horn, lights, or both
duration_ms	int	No	Pulse duration in ms (default 1000, max 5000)

Top case / battery compartment

Open the top case or battery compartment (e.g. scooter battery swaps). Availability depends on the vehicle.

INFO

POST /api/v1/admin/vehicles/{vehicle}/control/open-top-case

---

Vehicle state & telemetry

Get vehicle status

Retrieve the full real-time state snapshot for a vehicle, including location, telemetry, diagnostics, and connectivity. Only fields supported by the underlying OEM / telematics unit are populated.

INFO

GET /api/v1/admin/vehicles/{vehicle}/status

Response

{
  "success": true,
  "message": "Vehicle status retrieved",
  "data": {
    "vehicle_id": 1,
    "status": "available",
    "location": {
      "latitude": 25.0760,
      "longitude": 55.1340,
      "heading": 215,
      "address": "Dubai Marina, Dubai, UAE",
      "timestamp": "2024-01-15T10:00:00Z"
    },
    "telemetry": {
      "speed_kmh": 0,
      "mileage_km": 15420,
      "ignition": "off",
      "gear": "P",
      "parking_brake": "engaged",
      "fuel_level_percent": 85,
      "battery_level_percent": null,
      "remaining_range_km": 540,
      "charging_status": null,
      "onboard_voltage_v": 12.6,
      "is_locked": true,
      "is_engine_running": false,
      "doors": {
        "front_left": "closed",
        "front_right": "closed",
        "rear_left": "closed",
        "rear_right": "closed",
        "trunk": "closed"
      },
      "windows": {
        "front_left": "closed",
        "front_right": "closed",
        "rear_left": "closed",
        "rear_right": "closed"
      },
      "sunroof": "closed",
      "seatbelts": {
        "driver": "unfastened",
        "passenger": "unfastened"
      },
      "key_status": "out"
    },
    "diagnostics": {
      "dtcs": [],
      "service_due_in_km": 4580,
      "oil_life_percent": 78,
      "warning_lamps": []
    },
    "connectivity": {
      "status": "online",
      "last_seen": "2024-01-15T10:00:00Z",
      "signal_quality": "strong",
      "firmware_version": "tcu-3.4.1"
    },
    "oem_data": {}
  },
  "request_id": "uuid",
  "timestamp": "2024-01-15T10:00:00.000Z"
}

Field availability

Any field the OEM does not report is returned as null (or omitted entirely). For example, EV-only fields like battery_level_percent and charging_status will be null on combustion vehicles, and vice versa for fuel_level_percent.

---

Notes

• Admin users can control vehicles regardless of booking status.
• Commands are sent over cellular networks; response time is typically 2–10 seconds depending on coverage.
• Failed commands return a retry-after hint — see Error format.
• All control actions and status reads are logged in the activity history.