Device

This section contains a reference to a full list of parameters returned by Trustfull,
You can use this data catalogue as a reference in interpreting fields provided in our API responses.

General Data

NameDescription
customer_idCustomer id provided during the API call
resolution_idResolution id which identifies user document within TRUSTFULL.
device_request_timeThe Date Time when the request was made
webhook_urlThe URL from which the call originated from

Device Signals

NameTypeDescription
device_valuestringThe user agent submitted for scoring and enrichment

Ex: Mozilla/5.0 (Linux; Android 10; SM-G975F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.101 Mobile Safari/537.36
device_ageintegerYear of the commercial release of the device analyzed

Ex: 2018
device_brandstringThe company/organization that provides a device, browser, or other components to the market. It can be a manufacturer, mobile operator, or other organization exclusively offering a product

Ex: Samsung
device_browser_namestringThe name or type of the browser on the device. This property is dynamically populated at run time

Ex: Chrome
device_browser_versionstringThe browser version on the device. This property is dynamically populated at run time

Ex: 86
device_is_robotbooleanThe device of the user is detected to be a bot or a spider

Ex: true
device_modelstringThe full commercial name of the device enriched

Ex: iPhone 8
device_operating_systemstringThe operating system is installed on the device used by the customer

Ex: iOS
device_price_clusterstringIndicates the retail price of the device used by the customer

Ex: very_high

Enum: very_low, low, medium, high, very_high
device_price_usdstringIndicates the retail price in usd of the device used by the customer

Ex: 200
device_screen_size_heightintegerIndicates the height of the device screen, in pixels

Ex: 828
device_screen_size_widthintegerIndicates the width of the device screen, in pixels

Ex: 1792
device_categorystringIndicates the Primary hardware type of the user:

- Mobile Phone
- Desktop
- Tablet
- TV
- Games Console
- Digital Home Assistant
- Data Collection Terminal
- Telematics Control Unit
- Set Top Box
- Media Player
- Single-board Computer
- Refrigerator


Ex: Mobile Phone

Enum: Mobile Phone, Games Console, Digital Home Assistant, Refrigerator, Desktop, Data Collection Terminal, Telematics Control Unit, Tablet, TV, Set Top Box, ...
device_scoreintegerA number ranging from 0 to 1000 represents the quality of the device information detected

Ex: 649
device_score_clusterstringA cluster summarizing the quality of the IP address

Ex: very_high

Enum: very_low, low, review, high, very_high
device_reason_codesstringComma separated risk and trust signal for the product device.
For more information about reason codes you can go to Reason Codes

Ex: TP001,RP001
device_identity_email_countintegerThe number of email addresses associated with this device

Ex: 2
device_identity_ip_countintegerThe number of ip addresses associated with this device

Ex: 2
device_identity_msisdn_countintegerThe number of phones associated with this device

Ex: 2
device_identity_name_countintegerThe number of names associated with this phone number

Ex: 2

For more information about how to perform an api call you can go to Device API