Device

Trustfull's API endpoints are quite flexible and you can request a range of services from a single endpoint

One of the possible use cases is Device Detection

What is Device Detection?

Device Detection is a product that combines advanced device validation, data enrichment, and a specific AI model all based on a single touch point, the device number.

Request

following an example of a Device Detection

curl --request POST \
     --url https://api.fido.id/1.0/device \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --header 'x-api-key: [your_app_key]' \
     --data '
{
     "customer_id": "your_customer_id",
     "claims": [
          "device"
     ],
    "user_agent": "K10000 Pro Build/NRD90M"
}'

Response

Following an example of the response:

{
    "resolution_id": "...",
    "customer_id": "...",
    "device_request_time": "...",
    "webhook_url": "...",
    "claims": [
        "device"
    ],
    "value": "Mozilla/5.0 (Linux; Android 10; SM-G975F) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.101 Mobile Safari/537.36",
    "age": 2018,
    "brand": "Samsung",
    "browser_name": "Chrome",
    "browser_version": 86,
    "is_robot": true,
    "model": "iPhone 8",
    "operating_system": "iOS",
    "price_cluster": "very_high",
    "price_usd": 200,
    "screen_size_height": 828,
    "screen_size_width": 1792,
    "category": "Mobile Phone",
    "score": 649,
    "score_cluster": "very_high",
    "reason_codes": "TP001,RP001",
    "identity_email_count": 2,
    "identity_ip_count": 2,
    "identity_msisdn_count": 2,
    "identity_name_count": 2
}

RESPONSE

The following fields can be found under the "device" object

name	type
value	string The 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
age	integer Year of the commercial release of the device analyzed Ex: 2018
brand	string The 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
browser_name	string The name or type of the browser on the device. This property is dynamically populated at run time Ex: Chrome
browser_version	string The browser version on the device. This property is dynamically populated at run time Ex: 86
is_robot	boolean The device of the user is detected to be a bot or a spider Ex: true
model	string The full commercial name of the device enriched Ex: iPhone 8
operating_system	string The operating system is installed on the device used by the customer Ex: iOS
price_cluster	string Indicates the retail price of the device used by the customer Ex: very_high Enum: very_low,low,medium,high,very_high
price_usd	string Indicates the retail price in usd of the device used by the customer Ex: 200
screen_size_height	integer Indicates the height of the device screen, in pixels Ex: 828
screen_size_width	integer Indicates the width of the device screen, in pixels Ex: 1792
category	string Indicates 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, ...
score	integer A number ranging from 0 to 1000 represents the quality of the device information detected Ex: 649
score_cluster	string A cluster summarizing the quality of the IP address Ex: very_high Enum: very_low,low,review,high,very_high
reason_codes	string Comma separated risk and trust signal for the product device. For more information about reason codes you can go to Reason Codes Ex: TP001,RP001
identity_email_count	integer The number of email addresses associated with this device Ex: 2
identity_ip_count	integer The number of ip addresses associated with this device Ex: 2
identity_msisdn_count	integer The number of phones associated with this device Ex: 2
identity_name_count	integer The number of names associated with this phone number Ex: 2