Copy page

v1

Scoring Results

A successfully processed request returns HTTP 200.

Code
{
  "code": 200,
  "status": "success",
  "client_transaction_id": "insights-request-001",
  "data": {
    "score": 98
  },
  "balance": 100,
  "transaction_id": "019c1234-5678-7abc-8def-0123456789ab",
  "message": "insights successful"
}

Field	Type	Description
code	integer	HTTP-compatible response code.
status	string	success when scoring completes.
client_transaction_id	string	The transaction_id supplied in the request.
data.score	number	Biometric insight score from 1 to 100. No public pass threshold is defined by this endpoint.
balance	integer	Remaining service balance. For postpaid integrations, the response returns 100.
transaction_id	string	Privy's transaction identifier for support and tracing.
message	string	insights successful for a successful request.

Do not assume that a particular score passes or fails an issuance rule unless Privy has explicitly defined that interpretation for your integration.