Get unique fingerprints (devices) with their rolled-up behaviour

post

https://api.embermind.ch/api/v1/client/fingerprints/get-device-list

One row per unique fingerprint: sessions collected, transactions and distinct customers attributed to it, the mean fraud score of those transactions, the IP countries they came from, and the Fingerprint Smart Signals antidetect/proxy verdicts. Scrolled rather than paged — the response carries hasMore instead of a total.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

page

number

> 0

Page number (starts from 1)

perPage

number

0 to 500

Number of items per page (default 25, max 500)

sortBy

string

enum

Sort field (default LAST_SEEN_AT)

Allowed:

sortDirection

string

enum

Sort direction (default DESC)

Allowed:

dateFrom

date-time

Period start. Filters devices by LAST SEEN date only — every total on the row is lifetime and does not change with the period.

dateTo

date-time

Period end. Filters devices by LAST SEEN date only — every total on the row is lifetime and does not change with the period.

searchValue

string

Search by visitor id (fingerprintExternal) or internal fingerprint hash

antiDetectBrowser

string

enum

Filter by the antidetect-browser signal: TRUE — ever detected, FALSE — reported and never detected, UNKNOWN — Fingerprint has never reported on this device.

Allowed:

proxy

string

enum

Filter by the proxy signal: TRUE — ever detected, FALSE — reported and never detected, UNKNOWN — Fingerprint has never reported on this device.

Allowed:

avgFraudScoreMin

number

Minimum lifetime average fraud score across the device transactions

avgFraudScoreMax

number

Maximum lifetime average fraud score across the device transactions

sessionsCountMin

number

≥ 0

Minimum number of sessions ever collected for the device

sessionsCountMax

number

≥ 0

Maximum number of sessions ever collected for the device

customersCountMin

number

≥ 0

Minimum number of distinct customers ever seen on the device

customersCountMax

number

≥ 0

Maximum number of distinct customers ever seen on the device

transactionsCountMin

number

≥ 0

Minimum number of transactions ever attributed to the device

transactionsCountMax

number

≥ 0

Maximum number of transactions ever attributed to the device

countryList

array of strings

Keep devices whose transactions came from at least one of these IP countries (ISO-3166 alpha-2)

countryList

Headers

x-access-token

string

x-api-key

string

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Response

400Response

500Response