Parameters/api_get_vehicle_parameter_values

api_get_vehicle_parameter_valuestoken required

Returns telemetry parameter values (`telemetry.unit_parameter`) for a vehicle in a time window of up to 72 hours.

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

Parameters

NameTypeRequiredDescription
env_idnumberoptionalTenant environment id; defaults to the session env_id.e.g. 7
vehicle_idnumberoptionalVehicle id. Required if `license_nmbr` is not provided.e.g. 555
license_nmbrstringoptionalLicense plate. `License_NMBR` is also accepted as an alias. Required if `vehicle_id` is not provided.e.g. AB-123-CD
param_typestringoptionalOptional parameter-type code to filter on. If omitted, all types are returned.e.g. speed
start_timedaterequiredStart of the time window (inclusive).e.g. 2026-04-26T00:00:00Z
end_timedaterequiredEnd of the time window (exclusive). Must be after `start_time` and within 72 hours.e.g. 2026-04-27T00:00:00Z

Notes

Either `vehicle_id` or `license_nmbr`/`License_NMBR` must be provided. Window > 72h returns action_value '3'. Permissions enforced via auth.v_user_vehicle.

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_vehicle_parameter_values","parameters":[{"name":"env_id","value":7},{"name":"vehicle_id","value":555},{"name":"license_nmbr","value":"AB-123-CD"},{"name":"param_type","value":"speed"},{"name":"start_time","value":"2026-04-26T00:00:00Z"},{"name":"end_time","value":"2026-04-27T00:00:00Z"}]}}'
Body
{
  "action": {
    "name": "api_get_vehicle_parameter_values",
    "parameters": [
      {
        "name": "env_id",
        "value": "7"
      },
      {
        "name": "vehicle_id",
        "value": "555"
      },
      {
        "name": "license_nmbr",
        "value": "AB-123-CD"
      },
      {
        "name": "param_type",
        "value": "speed"
      },
      {
        "name": "start_time",
        "value": "2026-04-26T00:00:00Z"
      },
      {
        "name": "end_time",
        "value": "2026-04-27T00:00:00Z"
      }
    ]
  }
}

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_vehicle_parameter_values",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "vehicle_id": "555",
          "parameter_type": "speed",
          "parameter_type_description": "Vehicle speed",
          "value": "62.4",
          "time": "2026-04-27T08:14:55.0000000+00:00"
        }
      ]
    }
  }
}