Trips/get_trip_locations
get_trip_locationstoken required
Returns the breadcrumb locations (lat/lon, speed, mileage, status) for a single trip / drive.
POST
/api— body field action.name = "get_trip_locations"Parameters
| Name | Type | Required | Description |
|---|---|---|---|
drive_id | string | required | The drive/trip id to load locations for.e.g. 44321 |
env_id | number | optional | Tenant environment id; defaults to the session env_id.e.g. 7 |
version | string | optional | API version selector (currently only v1). Accepted but ignored.e.g. 1 |
Notes
Trip access is checked against the session's client_id; non-owned trips return action_value '2' with an empty data array.
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":"get_trip_locations","parameters":[{"name":"drive_id","value":"44321"},{"name":"env_id","value":7},{"name":"version","value":"1"}]}}'Body
{
"action": {
"name": "get_trip_locations",
"parameters": [
{
"name": "drive_id",
"value": "44321"
},
{
"name": "env_id",
"value": "7"
},
{
"name": "version",
"value": "1"
}
]
}
}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": "get_trip_locations",
"action_value": "0",
"description": "success",
"data": [
{
"trip_id": "44321",
"vehicle_id": "555",
"license_number": "AB-123-CD",
"time": "2026-04-27T08:01:30",
"latitude": "32.0855120",
"longitude": "34.7820100",
"direction": "182",
"speed": "55.20",
"mileage": "152301.40",
"vehicle_status": "1"
}
]
}
}
}