Vehicles/api_get_data

api_get_datatoken required

Returns the master vehicle list (last position, last event, driver, mileage, etc.) with optional filters.

POST/api— body field action.name = "api_get_data"

Parameters

NameTypeRequiredDescription
loginIdnumberoptionalLegacy login id used to scope results.e.g. 12345
license_nmbrstringoptionalLicense plate filter. The case-variant `License_NMBR` is also accepted.e.g. AB-123-CD
VinstringoptionalFilter by VIN / chassis serial.e.g. 1HGCM82633A004352
Unit_IDnumberoptionalTelematics unit id.e.g. 98765
vehicle_idnumberoptionalInternal vehicle id.e.g. 555
group_idnumberoptionalGroup / depot filter.e.g. 10
last_timedateoptionalOnly return vehicles updated after this timestamp. Parsed via `new Date()`.e.g. 2026-04-01T00:00:00Z
mileageCoeffnumberoptionalDivisor applied to speed and mileage values. Defaults to 1; cannot be 0.e.g. 1
env_idnumberoptionalTenant environment id. Falls back to the env_id stored on the session.e.g. 7

Notes

`license_nmbr` and `License_NMBR` are aliases. `mileageCoeff` defaults to 1 and divides speed/mileage. `env_id` is resolved from the session if not supplied.

Request

curl
curl -X POST 'https://api.develop-1.questar.io/v2/exodus/api' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data '{"action":{"name":"api_get_data","parameters":[{"name":"loginId","value":12345},{"name":"license_nmbr","value":"AB-123-CD"},{"name":"Vin","value":"1HGCM82633A004352"},{"name":"Unit_ID","value":98765},{"name":"vehicle_id","value":555},{"name":"group_id","value":10},{"name":"last_time","value":"2026-04-01T00:00:00Z"},{"name":"mileageCoeff","value":1},{"name":"env_id","value":7}]}}'
Body
{
  "action": {
    "name": "api_get_data",
    "parameters": [
      {
        "name": "loginId",
        "value": "12345"
      },
      {
        "name": "license_nmbr",
        "value": "AB-123-CD"
      },
      {
        "name": "Vin",
        "value": "1HGCM82633A004352"
      },
      {
        "name": "Unit_ID",
        "value": "98765"
      },
      {
        "name": "vehicle_id",
        "value": "555"
      },
      {
        "name": "group_id",
        "value": "10"
      },
      {
        "name": "last_time",
        "value": "2026-04-01T00:00:00Z"
      },
      {
        "name": "mileageCoeff",
        "value": "1"
      },
      {
        "name": "env_id",
        "value": "7"
      }
    ]
  }
}

Response

Successful responses always wrap the action's payload in response.properties. The action_value field reports the handler outcome: "0" for success, "1" for invalid params, "2" for not allowed, "999" for general error.

200 OK
{
  "response": {
    "properties": {
      "action_name": "api_get_data",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "vehicle_id": "555",
          "unit_id": "98765",
          "group_id": "10",
          "group_name": "Tel%20Aviv%20Fleet",
          "client_id": "42",
          "client_name": "Acme%20Logistics",
          "company_no": "100200",
          "unit_serial": "0000000000123456",
          "license_nmbr": "AB-123-CD",
          "chassis_number": "1HGCM82633A004352",
          "last_communication_time": "2026-04-27T08:15:00Z",
          "last_position_time": "2026-04-27T08:14:55Z",
          "latitude": "32.0853000",
          "longitude": "34.7818000",
          "speed": "62.40",
          "direction": "180",
          "status": "1",
          "last_event_time": "2026-04-27T08:14:00Z",
          "last_event_type": "Ignition%20On",
          "current_driver": "789",
          "current_driver_number": "DRV-789",
          "driver_name": "John Doe",
          "worker_id": "W-789",
          "current_drive": "44321",
          "last_mileage": "152340.25",
          "engine_hours": "8721.50",
          "charge_hours": "112",
          "manufacturer": "Volvo",
          "model": "FH16",
          "sub_model": "FH16-540"
        }
      ]
    }
  }
}