External API
Docs & Playground
Admin/Lookup/get_id_center_data

get_id_center_datatoken required

Returns ID-center identifiers (CI, software, CVN, parameter values) for a set of vehicles or groups at a reference time.

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

Parameters

NameTypeRequiredDescription
reference_timedaterequiredReference timestamp for the snapshot.e.g. 2026-04-27T08:00:00Z
vehicle_idsstringoptionalComma-separated positive vehicle ids. Mutually exclusive with `group_ids`; one of the two is required.e.g. 555,556,557
group_idsstringoptionalComma-separated positive group ids. Mutually exclusive with `vehicle_ids`.e.g. 10,11
id_typenumberoptional0=all (default), 1=CI, 2=SOFTWARE, 3=CVN, 4=param_type. Must be 0–4.e.g. 0

Notes

env_id is taken from the session only — no parameter override. `reference_time` is required. Exactly one of `vehicle_ids` or `group_ids` must be provided (mutually exclusive). `id_type` defaults to `'0'` (all) and must be 0–4. Tenant isolation applied via session.clientId.

Request

curl
curl -X POST 'https://private.develop-1.questar.io/v2/private-questar-units/api' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  --data '{"action":{"name":"get_id_center_data","parameters":[{"reference_time":"2026-04-27T08:00:00Z","vehicle_ids":"555,556,557","group_ids":"10,11","id_type":0}]}}'
Body
{
  "action": {
    "name": "get_id_center_data",
    "parameters": [
      {
        "reference_time": "2026-04-27T08:00:00Z",
        "vehicle_ids": "555,556,557",
        "group_ids": "10,11",
        "id_type": 0
      }
    ]
  }
}

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, "3" for limit-exceeded /pagination-session-expired, "999" for general error.

Authentication is checked before the action runs and fails the same way for every action. A token that is not valid returns HTTP 200 with action_value "2" and description invalid_session; an empty bearer returns "2" with session_token_required. Read the description to tell these apart from an action's own "2". With no Authorization header the gateway answers HTTP 401 {"message":"Unauthorized"}, and with a bearer that is not a token HTTP 403 {"message":"Forbidden"}.

200 OK
{
  "response": {
    "properties": {
      "action_name": "get_id_center_data",
      "action_value": "0",
      "description": "success",
      "data": [
        {
          "vehicle_id": "555",
          "vin": "1HGCM82633A004352",
          "source_address": "0x00",
          "source_name": "ECM",
          "channel": "CAN1",
          "id_type": "1",
          "id_type_descr": "CI",
          "id_name": "Calibration Identification",
          "id_value": "ABC123",
          "id_value_first_seen": "2025-12-01T08:00:00Z",
          "id_value_last_seen": "2026-04-27T08:00:00Z",
          "id_current_value": "ABC123",
          "id_current_value_last_seen": "2026-04-27T08:00:00Z"
        }
      ]
    }
  }
}