E
Exodus API
Docs & Playground
Trips/get_vehicle_trips_extended

get_vehicle_trips_extendedtoken required

Returns enriched trip rows (fuel, idle, DOA, safety, geocoded start/end) for one or more vehicles or a driver.

Try in playground
POST/api— body field action.name = "get_vehicle_trips_extended"

Parameters

NameTypeRequiredDescription
vehicle_idstringoptionalSingle id, or a comma-separated list of up to 100 vehicle ids.e.g. 555,556,557
license_numberstringoptionalLicense plate filter. Aliases: `license_nmbr`, `License_NMBR`. Resolved to a single vehicle id.e.g. AB-123-CD
driver_idnumberoptionalDriver id. Required if no vehicle filter is supplied.e.g. 789
from_datedateoptionalStart of the date range (YYYY-MM-DD). Must be set together with `to_date`. Defaults to today.e.g. 2026-04-01
to_datedateoptionalEnd of the date range (YYYY-MM-DD). Inclusive. Range cannot exceed 32 days.e.g. 2026-04-27

Notes

env_id is taken from the session only — no parameter override. Provide one or more of `vehicle_id` / `license_number` / `driver_id`. Up to 100 vehicle ids per call. License aliases `license_nmbr`/`License_NMBR` accepted. `from_date` and `to_date` must both be set or both omitted; when both are omitted the window defaults to today only (single UTC day). Range > 32 days returns action_value '1'. Locations are reverse-geocoded via Google Maps; geocoding failures return empty strings rather than failing the request.

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":"get_vehicle_trips_extended","parameters":[{"name":"vehicle_id","value":"555,556,557"},{"name":"license_number","value":"AB-123-CD"},{"name":"driver_id","value":789},{"name":"from_date","value":"2026-04-01"},{"name":"to_date","value":"2026-04-27"}]}}'
Body
{
  "action": {
    "name": "get_vehicle_trips_extended",
    "parameters": [
      {
        "name": "vehicle_id",
        "value": "555,556,557"
      },
      {
        "name": "license_number",
        "value": "AB-123-CD"
      },
      {
        "name": "driver_id",
        "value": "789"
      },
      {
        "name": "from_date",
        "value": "2026-04-01"
      },
      {
        "name": "to_date",
        "value": "2026-04-27"
      }
    ]
  }
}

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_vehicle_trips_extended",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "drive_id": "44321",
          "vehicle_id": "555",
          "license_number": "AB-123-CD",
          "vehicle_group": "Tel Aviv Fleet",
          "parent_group": "",
          "upper_group": "",
          "top_group": "",
          "driver_name": "John Doe",
          "driver_code": "DRV-789",
          "driver_group": "",
          "worker_id": "W-789",
          "start_latitude": "32.0853000",
          "start_longitude": "34.7818000",
          "start_mileage": "152300.10",
          "end_latitude": "32.1093000",
          "end_longitude": "34.8555000",
          "distance": "12.45",
          "drive_duration": "00:23:11",
          "start_fuel_level_percent": "82.00",
          "end_fuel_level_percent": "78.00",
          "fuel_used": "1.40",
          "idle_time": "00:01:30",
          "total_mileage": "152312.55",
          "doa_dist": "0.00",
          "doa_dist_percent": "",
          "doa_time": "0",
          "doa_time_percent": "",
          "engine_hours": "0.39",
          "water_used": "0.00000",
          "driver_id": "789",
          "start_time": "2026-04-27T08:00:00Z",
          "end_time": "2026-04-27T08:23:11Z",
          "start_location": "Rothschild Blvd, Tel Aviv",
          "end_location": "Hayarkon St, Tel Aviv",
          "chassis_serial": "",
          "liter_Per_100_km": "11.24",
          "time_from_prev_drive": "00:14:00",
          "km_per_1_Liter": "8.89",
          "safety_score": "95",
          "main_driver": "",
          "main_driver_name": "",
          "main_driver_code": "",
          "energy_type": "",
          "CO2": "",
          "avg_speed": "32.218",
          "trailer": ""
        }
      ]
    }
  }
}