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
| Name | Type | Required | Description |
|---|---|---|---|
loginId | number | optional | Legacy login id used to scope results.e.g. 12345 |
license_nmbr | string | optional | License plate filter. The case-variant `License_NMBR` is also accepted.e.g. AB-123-CD |
Vin | string | optional | Filter by VIN / chassis serial.e.g. 1HGCM82633A004352 |
Unit_ID | number | optional | Telematics unit id.e.g. 98765 |
vehicle_id | number | optional | Internal vehicle id.e.g. 555 |
group_id | number | optional | Group / depot filter.e.g. 10 |
last_time | date | optional | Only return vehicles updated after this timestamp. Parsed via `new Date()`.e.g. 2026-04-01T00:00:00Z |
mileageCoeff | number | optional | Divisor applied to speed and mileage values. Defaults to 1; cannot be 0.e.g. 1 |
env_id | number | optional | Tenant 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.stage.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"
}
]
}
}
}