​

ves-io-schema-shape-device_intelligence-CustomAPI-GetDeviceSummary

Published April 5, 2023 | Last modified October 28, 2026

Examples of performing device_intelligence CustomAPI GetDeviceSummary

Usecase:

GetDeviceSummary

Request:

Request using vesctl:

vesctl request rpc device_intelligence.CustomAPI.GetDeviceSummary -i request.yaml --uri /public/namespaces/{namespace}/devices/{device_id}/summary --http-method POST

where file request.yaml has following contents:

{}

vesctl yaml response:

detectedSignals: []
location: []

Request using curl:

curl -X 'POST' -d '{}' -H 'Content-Type: application/json' -H 'X-Volterra-Useragent: v1/pgm=_var_folders_q2_3kp8z3zs0x5_m7pk1bgb0_ph0000gp_T_go-build3348201650_b001_apidocs.test/host=MTY6VVHQPH/svc=S:examplesvc/site=mytestce01' 'https://acmecorp.console.ves.volterra.io/api/device-intelligence/namespaces/%7Bnamespace%7D/devices/%7Bdevice_id%7D/summary'

curl response:

HTTP/1.1 200 OK
Content-Length: 268
Content-Type: application/json
Date: Mon, 28 Sep 2026 04:29:29 GMT
Vary: Accept-Encoding


{
  "device_risk_score": 0,
  "confidence": 0,
  "high_risk_txn_count": "0",
  "action_taken": "",
  "new_or_returning_device": "",
  "hosting": "",
  "ip_address": "",
  "location": [
  ],
  "channel": "",
  "user_agent": "",
  "os": "",
  "detected_signals": [
  ]
}
On this page: