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

Whether to return only verdict reasons that have overrides set. Defaults to false.

Response fields

request_id string

Globally unique UUID that is returned with every API call. This value is important to log for debugging purposes; we may ask for this value to help identify a specific API call when helping you debug an issue.

status_code int

The HTTP status code of the response. Stytch follows standard HTTP response status code patterns, e.g. 2XX values equate to success, 3XX values are redirects, 4XX are client errors, and 5XX are server errors.

verdict_reason_actions object

Information about verdict reasons and any overrides that were set on them.

verdict_reason string

The verdict reason.

override_action string

If not null, this action will be returned for the specified verdict reason in a fingerprint lookup, in place of the default action.

default_action string

The default action returned for the specified verdict reason in a fingerprint lookup when no overrides are specified.

override_created_at string

The time when the override was created, if one exists. Values conform to the RFC 3339 standard and are expressed in UTC, e.g. 2021-12-29T12:33:09Z.

override_description string

A description of the override, if one exists.

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 200

{
  "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
}

RESPONSE 401

{
  "status_code": 401,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "unauthorized_credentials",
  "error_message": "Unauthorized credentials.",
  "error_url": "https://stytch.com/docs/api/errors/401"
}

RESPONSE 429

{
  "status_code": 429,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "too_many_requests",
  "error_message": "Too many requests have been made.",
  "error_url": "https://stytch.com/docs/api/errors/429"
}

RESPONSE 500

{
  "status_code": 500,
  "request_id": "request-id-test-b05c992f-ebdc-489d-a754-c7e70ba13141",
  "error_type": "internal_server_error",
  "error_message": "Oops, something seems to have gone wrong, please reach out to support@stytch.com to let us know what went wrong.",
  "error_url": "https://stytch.com/docs/api/errors/500"
}