Navigation

Retrieve an evaluation

Retrieve an evaluation by its ID to read its verdict, the reasons behind it, and any risk signals. Use this from your backend to confirm a verdict the client SDK produced before you act on it.

Retrieving an evaluation does not change it. To mark an evaluation as used so it can't be acted on again, see consume an evaluation.

Parameters

No parameters

Returns

Returns an evaluation object.
GET/v3/evaluations/:id
const evaluation = await rupt.getEvaluation(EVALUATION_ID);
Response
{
  "id": "649873be6e8b6f9b33722a0c",
  "action": "login",
  "verdict": "challenge",
  "reasons": ["new_fingerprint", "new_ip"],
  "redirect": "https://challenge.rupt.dev/?challenge=649873be6e8b6f9b33722a0c",
  "user": {
    "rupt_id": "649873be6e8b6f9b33722a0c",
    "id": "external_account_id",
    "email": "user@example.com",
    "phone": "+15551234567"
  },
  "challenge": {
    "id": "649873be6e8b6f9b33722a0c",
    "status": "created",
    "type": "account_takeover"
  },
  "risk_summary": [{ "category": "ato", "severity": "low" }],
  "consumed": false,
  "createdAt": "2021-09-01T00:00:00.000Z",
  "updatedAt": "2021-09-01T00:00:00.000Z"
}