E
Exodus API
Docs & Playground
Trips/get_vehicle_trips

get_vehicle_tripstoken required

Returns a basic trip list (start/end time, distance, geocoded start/end) for a vehicle or driver.

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

Parameters

NameTypeRequiredDescription
env_idnumberoptionalTenant environment id; defaults to the session env_id.e.g. 7
vehicle_idnumberoptionalVehicle id. At least one of vehicle_id / license_number / driver_id is required.e.g. 555
license_numberstringoptionalLicense plate. Aliases: `license_nmbr`, `License_NMBR`.e.g. AB-123-CD
driver_idnumberoptionalDriver id (positive integer).e.g. 789
from_datedateoptionalStart of date range (YYYY-MM-DD). Must be paired with `to_date`. Defaults to today.e.g. 2026-04-01
to_datedateoptionalEnd of date range (YYYY-MM-DD). Range cannot exceed 32 days.e.g. 2026-04-27

Notes

Provide vehicle_id, license_number, or driver_id. `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 '3'. Client filter inherited from session.

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","parameters":[{"name":"env_id","value":7},{"name":"vehicle_id","value":555},{"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",
    "parameters": [
      {
        "name": "env_id",
        "value": "7"
      },
      {
        "name": "vehicle_id",
        "value": "555"
      },
      {
        "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",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "vehicle_id": "555",
          "license_number": "AB-123-CD",
          "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",
          "drive_id": "44321",
          "distance": "12.45",
          "start_latitude": "32.0853000",
          "start_longitude": "34.7818000",
          "end_latitude": "32.1093000",
          "end_longitude": "34.8555000",
          "client_id": "42",
          "client_name": "Acme Logistics"
        }
      ]
    }
  }
}