Get Verdict Reasons

POST

https://telemetry.stytch.com/v1/verdict_reasons/list

Get the list of verdict reasons returned by the Stytch Device Fingerprinting product along with their default actions and any overrides you may have defined. This is not an exhaustive list of verdict reasons, but it contains all verdict reasons that you may set an override on.

For a full list of possible verdict reasons, see Warning Flags (Verdict Reasons).

Body parameters

overrides_only boolean

Response fields

request_id string

status_code int

verdict_reason_actions object

const stytch = require('stytch');

const client = new stytch.Client({
  project_id: 'PROJECT_ID',
  secret: 'SECRET',
});

const params = {
};

client.fraud.verdictReasons.list(params)
  .then(resp => { console.log(resp) })
  .catch(err => { console.log(err) });

RESPONSE

{
  "verdict_reason_overrides": [
    {
      "default_action": "BLOCK",
      "override_action": null,
      "override_created_at": null,
      "override_description": null,
      "verdict_reason": "AD_BLOCKER_DETECTED"
    },
    {
      "default_action": "CHALLENGE",
      "override_action": "ALLOW",
      "override_created_at": "2025-06-09T00:00:00Z",
      "override_description": null,
      "verdict_reason": "VIRTUAL_MACHINE"
    },
    ...
  ],
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "status_code": 200
}