API

List drivers

GEThttps://lemurseye.com/api/v1/drivers

Returns every driver in your company, active or not.

Permission: drivers:read. The token is sent as Authorization: Bearer <token>; see Authentication.

Response

200

An array of drivers.

Response fields

iduuid
The driver's id.
namestring
Full name.
phonestring | null
Phone number.
licenceNostring | null
Driving licence number.
licenceExpirydate | null
Licence expiry (YYYY-MM-DD).
tagIdstring | null
ID tag (iButton / RFID) the tracker reads, unique in your company.
activeboolean
Inactive drivers keep their history but cannot sign in or be a vehicle's usual driver.
notesstring | null
Free text.
vehicleIdsuuid[]
Vehicles whose usual driver this is.
hasCodeboolean
Whether an app code has been issued (the code itself is never returned again).
createdAttimestamp
When the driver was added.

Errors

Where a message is listed, it comes back as JSON: { "error": "..." }. Otherwise only the status code is returned.

401
No token, or it has expired.
403
The token lacks the permission above.

curl --request GET \
  --url https://lemurseye.com/api/v1/drivers \
  --header "Authorization: Bearer $LEMURSEYE_TOKEN"

Response200

[
  {
    "id": "7a2e9c41-3d5b-4f8a-b6c2-0e1f2a3b4c5d",
    "name": "Ahmed Saleh",
    "phone": "+966551234567",
    "licenceNo": "1029384756",
    "licenceExpiry": "2028-03-31",
    "tagId": "04A2B91C",
    "active": true,
    "notes": null,
    "vehicleIds": [
      "3f6c2a1e-8b4d-4c0e-9a7f-1d2e3b4c5a6f"
    ],
    "hasCode": true,
    "createdAt": "2026-11-01T07:00:00Z"
  }
]

← Reactivate a tracker Create a driver →