×
  (c) Pilot Telematics, 2024

Get account vehicles status

This API allows you to retrieve the full list of vehicles associated with a specific account, along with their current status and basic information.
 

How to retrieve data

Method

GET

Request address

Use the following URL to request data:
https://<address>/api/api.php?
<address> — your server address

Request parameters:

Add the following parameters to your request URL:
  • cmd=vehicles — command to get the list of vehicles
  • account_id — the account ID for which you want to get the vehicle list
Optional parameters:
  • is_show_deleted — show deleted vehicles
    (0 — only active vehicles, 1 — all vehicles, including deleted ones)
Response format:
The response is a JSON array with vehicle data.

Example Request (with deleted vehicles included)

API request:
https://<address>/backend/api/api.php?cmd=vehicles&account_id=2238&is_show_deleted=1
API response:
{
  "data": [
    {
      "active": 1,
      "deleted": 0,
      "agentid": 2914,
      "configuration": "Teltonika FM1100",
      "current_mileage": 69332,
      "dir": 0,
      "driver_name": "SSS",
      "driver_phone": "",
      "folder": "ЮФО",
      "lat": "47.200989",
      "lon": "39.634436",
      "model": "HYUNDAI IX35",
      "msisdn": "79818775160",
      "on": 1,
      "partner_price": "0.00",
      "price": "0.00",
      "sats": 7,
      "speed": 0,
      "ts": "1457709039",
      "type": "Static",
      "uniqid": "356307045913463",
      "vehiclenumber": "IX35"
    },
    {
      "active": 0,
      "deleted": 1,
      "agentid": 8026,
      "configuration": "Teltonika FM4200",
      "current_mileage": 17441,
      "dir": 0,
      "driver_name": "",
      "driver_phone": "",
      "folder": "ЮФО",
      "lat": "47.318118",
      "lon": "39.995648",
      "model": "",
      "msisdn": "79110181596",
      "on": 1,
      "partner_price": "100.00",
      "price": "350.00",
      "sats": 9,
      "speed": 0,
      "ts": "1457726726",
      "type": "Car",
      "uniqid": "354330031297057",
      "vehiclenumber": "nex"
    }
  ]
}

Response parameters

The response is returned in JSON format and contains:
  • active — vehicle status: 1 = active, 0 = inactive
  • deleted — whether the vehicle is deleted: 0 = not deleted, 1 = deleted
  • agentid — unique device ID
  • configuration — GPS device configuration name (e.g., Teltonika FM1100)
  • current_mileage — vehicle mileage, km
  • dir — direction of movement
  • driver_name — driver’s name (if assigned)
  • driver_phone — driver’s phone number
  • folder — folder/category name in the system
  • lat — latitude of the last known position
  • lon — longitude of the last known position
  • model — vehicle model
  • msisdn — SIM card number of the tracker
  • on — ignition status (1 = on, 0 = off)
  • partner_price — partner price
  • price — retail price
  • sats — number of satellites in view
  • speed — current speed, km/h
  • ts — timestamp (UNIX time) of the last position update
  • type — object type
  • uniqid — unique device identifier (usually IMEI)
  • vehiclenumber — vehicle number or label