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

Language
URL
Click Try It! to start a request and see the response here!