TRtrulioo
Device Intelligence

Get transaction device detail

Returns the current transaction-scoped device result for the authenticated organization. The response includes normalized device data, observed signals, and evaluation context.

Poll this endpoint while it returns 202 Accepted. When processing is complete, it returns 200 OK.

Source risk fields are normalized into the Trulioo evaluation returned by this API. Use evaluation.riskBand for programmatic categorization, evaluation.riskLevel for display text, and evaluation.riskScore for numeric ordering or comparison. Do not treat the normalized score as an unmodified source score. For compatibility, when an evaluation is present, device.risk.riskScore and device.risk.riskLevel repeat the corresponding public evaluation values; they are not separate raw source values.

get/transactions/{transactionId}/devices

Request

  • Base URL
    https://verification.trulioo.com
  • URL
    https://verification.trulioo.com/transactions/{transactionId}/devices
  • Auth
    HTTP bearer

Path parameters

transactionIdstring uuid required

The UUID of the transaction whose device result is requested. The transaction must belong to the organization represented by the bearer token.

Response

The latest device event has reached a terminal state. The response contains the current transaction-scoped device result.

transactionIdstring uuid required

Transaction identifier.

schemaFamily'DEVICE_INTELLIGENCE' | 'BEHAVIOR_BIOMETRICS' nullable

Normalized schema family for the selected device result. It is null when no device result has been classified.

platform'ANDROID' | 'IOS' | 'WEB' | 'UNKNOWN' nullable

Normalized device platform. It is null when the platform is unknown or processing is incomplete.

Example response

{
  "transactionId": "550e8400-e29b-41d4-a716-446655440000",
  "schemaFamily": "DEVICE_INTELLIGENCE",
  "platform": "ANDROID",
  "device": {
    "identity": {
      "deviceId": "0S4H7K2P9Q1M",
      "packageName": "com.example.mobileapp",
      "model": "SM-S938W"
    }
  },
  "signals": [
    {
      "name": "IP Security VPN",
      "category": "Network Security",
      "label": "VPN",
      "valueType": "BOOLEAN",
      "signalKey": "IP_SECURITY_VPN",
      "result": "Detected",
      "insight": "Connection appears to be routed through a VPN."
    }
  ],
  "insights": [
    {
      "signal": "IP_SECURITY_VPN",
      "category": "Network Security",
      "label": "VPN",
      "result": "Detected",
      "insight": "Connection appears to be routed through a VPN."
    }
  ],
  "evaluation": {
    "riskScore": 87,
    "riskLevel": "High Risk",
    "decision": "REVIEW",
    "riskBand": "HIGH_RISK"
  },
  "association": {
    "deviceId": "0S4H7K2P9Q1M",
    "eventCount": 4,
    "deviceCount": 1
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.