Identify visitor

Exchange a browser-collected Fingerprint event ID for FINAP’s normalized identity and risk result.

POST/identify

Service: Fingerprint
Billing: On success

Request

requestIdrequired

string

A non-empty Fingerprint event ID, at most 128 characters.

curl https://api.finap.uk/api/v1/identify -X POST \
  -H "Authorization: Bearer $FINAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"requestId":"event_id_from_browser"}'

Response fields

visitorId

string

Stable visitor identifier.

requestId

string

The resolved event ID.

riskScore

number

Normalized risk score from 0 to 1.

confidence.score

number

Identification confidence.

incognito

boolean

Whether private browsing was detected.

durationMs

number

Server processing duration.