Skip to main content
POST
fraud.device.inspect

Authorizations

Authorization
string
header
required

API key: sk_live_…

Headers

Idempotency-Key
string
required

Required: this capability has an external effect.

Maximum string length: 255
Pramaan-Account
string

Optional. One of your account ids (GET /v1/accounts): run on that account, whatever your routing rules say. The response header X-Pramaan-Account names the account that ran.

Pramaan-End-User
string

Optional. Your own tag for your end user: a sticky: end_user rule keeps them on the account that first served them.

Maximum string length: 256
Pramaan-End-User-Group
string

Optional. Your end user's group, matched by rules with endUserGroup.

Maximum string length: 64

Body

application/json
eventKey
string
required

Your stable event key.

Required string length: 1 - 255
subjectKey
string
required

Your stable subject key.

Required string length: 1 - 256
session
string
required

Authentic device session collected by your own client.

Required string length: 1 - 100000
locationMode
enum<string>

Explicit location result group; omitted means no location.

Available options:
basic,
extended,
network

Response

The result

os
string

Operating system.

Required string length: 1 - 100
browser
string

Browser.

Required string length: 1 - 100
browserVersion
string

Browser version.

Required string length: 1 - 100
deviceType
string

Device kind.

Required string length: 1 - 100
platform
string

Hardware platform.

Required string length: 1 - 100
privateBrowsing
boolean

Private browsing observed.

automated
boolean

Automation observed.

remoteAccess
boolean

Remote access observed.

tampered
boolean

Device tampering observed.

location
object

Location facts, when available.

ref
string

Reference to what this call created. Pass it as ref to Follow-up calls for fraud_transaction..