---
title: "List rule evaluation results"
method: GET
path: "/v2/auth_rules/results"
tags: ["Auth Rules"]
---

# List rule evaluation results

`GET /v2/auth_rules/results`

Lists Auth Rule evaluation results.

**Limitations:**
- Results are available for the past 3 months only
- At least one filter (`event_token` or `auth_rule_token`) must be provided
- When filtering by `event_token`, pagination is not supported

## Query parameters

- `ending_before` string, uuid
- `page_size` integer
- `starting_after` string, uuid
- `event_token` string, uuid
- `auth_rule_token` string, uuid
- `begin` string, date-time
- `end` string, date-time
- `has_actions` boolean

## Response `200`

Auth Rule Results

- object
  - `data` AuthRuleResult[], required
    - union — Result of an Auth Rule evaluation
      - object
        - `token` string, uuid, required — Globally unique identifier for the evaluation
        - `auth_rule_token` string, uuid, required — The Auth Rule token
        - `event_token` string, uuid, required — Token of the event that triggered the evaluation
        - `evaluation_time` string, date-time, required — Timestamp of the rule evaluation
        - `rule_version` integer, required — Version of the rule that was evaluated
        - `transaction_token` string, uuid, nullable, required — The token of the transaction that triggered the rule evaluation
        - `mode` 'ACTIVE' | 'INACTIVE', required — The state of the Auth Rule
        - `event_stream` 'AUTHORIZATION', required — The event stream during which the rule was evaluated
        - `actions` union[], required — Actions returned by the rule evaluation
          - union
            - object
              - …
            - object
              - …
      - object
        - `token` string, uuid, required — Globally unique identifier for the evaluation
        - `auth_rule_token` string, uuid, required — The Auth Rule token
        - `event_token` string, uuid, required — Token of the event that triggered the evaluation
        - `evaluation_time` string, date-time, required — Timestamp of the rule evaluation
        - `rule_version` integer, required — Version of the rule that was evaluated
        - `transaction_token` string, uuid, nullable, required — The token of the transaction that triggered the rule evaluation
        - `mode` 'ACTIVE' | 'INACTIVE', required — The state of the Auth Rule
        - `event_stream` 'THREE_DS_AUTHENTICATION', required — The event stream during which the rule was evaluated
        - `actions` object[], required — Actions returned by the rule evaluation
          - `type` 'DECLINE' | 'CHALLENGE', required
          - `explanation` string — Optional explanation for why this action was taken
      - object
        - `token` string, uuid, required — Globally unique identifier for the evaluation
        - `auth_rule_token` string, uuid, required — The Auth Rule token
        - `event_token` string, uuid, required — Token of the event that triggered the evaluation
        - `evaluation_time` string, date-time, required — Timestamp of the rule evaluation
        - `rule_version` integer, required — Version of the rule that was evaluated
        - `transaction_token` string, uuid, nullable, required — The token of the transaction that triggered the rule evaluation
        - `mode` 'ACTIVE' | 'INACTIVE', required — The state of the Auth Rule
        - `event_stream` 'TOKENIZATION', required — The event stream during which the rule was evaluated
        - `actions` union[], required — Actions returned by the rule evaluation
          - union
            - object
              - …
            - object
              - …
      - object
        - `token` string, uuid, required — Globally unique identifier for the evaluation
        - `auth_rule_token` string, uuid, required — The Auth Rule token
        - `event_token` string, uuid, required — Token of the event that triggered the evaluation
        - `evaluation_time` string, date-time, required — Timestamp of the rule evaluation
        - `rule_version` integer, required — Version of the rule that was evaluated
        - `transaction_token` string, uuid, nullable, required — The token of the transaction that triggered the rule evaluation
        - `mode` 'ACTIVE' | 'INACTIVE', required — The state of the Auth Rule
        - `event_stream` 'ACH_CREDIT_RECEIPT' | 'ACH_DEBIT_RECEIPT', required — The event stream during which the rule was evaluated
        - `actions` union[], required — Actions returned by the rule evaluation
          - union
            - object
              - …
            - object
              - …
      - object
        - `token` string, uuid, required — Globally unique identifier for the evaluation
        - `auth_rule_token` string, uuid, required — The Auth Rule token
        - `event_token` string, uuid, required — Token of the event that triggered the evaluation
        - `evaluation_time` string, date-time, required — Timestamp of the rule evaluation
        - `rule_version` integer, required — Version of the rule that was evaluated
        - `transaction_token` string, uuid, nullable, required — The token of the transaction that triggered the rule evaluation
        - `mode` 'ACTIVE' | 'INACTIVE', required — The state of the Auth Rule
        - `event_stream` 'CARD_TRANSACTION_UPDATE', required — The event stream during which the rule was evaluated
        - `actions` union[], required — Actions returned by the rule evaluation
          - union
            - object
              - …
            - object
              - …
      - object
        - `token` string, uuid, required — Globally unique identifier for the evaluation
        - `auth_rule_token` string, uuid, required — The Auth Rule token
        - `event_token` string, uuid, required — Token of the event that triggered the evaluation
        - `evaluation_time` string, date-time, required — Timestamp of the rule evaluation
        - `rule_version` integer, required — Version of the rule that was evaluated
        - `transaction_token` string, uuid, nullable, required — The token of the transaction that triggered the rule evaluation
        - `mode` 'ACTIVE' | 'INACTIVE', required — The state of the Auth Rule
        - `event_stream` 'ACH_PAYMENT_UPDATE', required — The event stream during which the rule was evaluated
        - `actions` union[], required — Actions returned by the rule evaluation
          - union
            - object
              - …
            - object
              - …
  - `has_more` boolean, required — Indicates whether there are more results to be retrieved by paging through the results.

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/versions/53ab5d4e2adb/schema)