---
title: "Retrieve a performance report"
method: GET
path: "/v2/auth_rules/{auth_rule_token}/report"
tags: ["Auth Rules"]
---

# Retrieve a performance report

`GET /v2/auth_rules/{auth_rule_token}/report`

Retrieves a performance report for an Auth rule containing daily statistics and evaluation outcomes.

**Time Range Limitations:**
- Reports are supported for the past 3 months only
- Maximum interval length is 1 month
- Report data is available only through the previous day in UTC (current day data is not available)

The report provides daily statistics for both current and draft versions of the Auth rule, including approval, decline, and challenge counts along with sample events.

## Path parameters

- `auth_rule_token` string, uuid, required

## Query parameters

- `begin` string, date, required
- `end` string, date, required

## Response `200`

Auth Rule Performance Report

- PerformanceReportV2
  - `auth_rule_token` string, uuid, required — Auth Rule Token
  - `begin` string, date, required — The start date (UTC) of the report.
  - `end` string, date, required — The end date (UTC) of the report.
  - `daily_statistics` object[], required — Daily evaluation statistics for the Auth Rule.
    - `date` string, date, required — The date (UTC) for which the statistics are reported.
    - `versions` ReportStatsV2[], required — Statistics for each version of the rule that was evaluated during the reported day.
      - `version` integer, required — The rule version number.
      - `state` 'ACTIVE' | 'SHADOW' | 'INACTIVE', required — The current state of this version.
      - `action_counts` object, required — A mapping of action types to the number of times that action was returned by this version during the relevant period. Actions are the possible outcomes of a rule evaluation, such as DECLINE, CHALLENGE, REQUIRE_TFA, etc. In case rule didn't trigger any action, it's counted under NO_ACTION key.
      - `examples` object[], required — Example events and their outcomes for this version.
        - `event_token` string, uuid, required — The event token.
        - `transaction_token` string, uuid, nullable — The token of the transaction associated with the event
        - `timestamp` string, date-time, required — The timestamp of the event.
        - `actions` union[], required — The actions taken by this version for this event.
          - union
            - union
              - …
            - ResultAuthentication3dsAction
              - …
            - union
              - …
            - union
              - …

## Other responses

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

## Changes

- **2026-07-20** `7732c7d99b3e` — 1 info
  - api operation id `getAuthRuleReport` was added
- **2026-04-10** `df28ee30a3bd` — 2 breaking
  - removed the required property `daily_statistics/items/current_version_statistics` from the response with the `200` status
  - removed the required property `daily_statistics/items/draft_version_statistics` from the response with the `200` status
- **2026-04-09** `bc1866f92f50` — 3 info
  - added the optional property `daily_statistics/items/current_version_statistics/examples/items/transaction_token` to the response with the `200` status
  - added the optional property `daily_statistics/items/draft_version_statistics/examples/items/transaction_token` to the response with the `200` status
  - added the optional property `daily_statistics/items/versions/items/examples/items/transaction_token` to the response with the `200` status

[Change history](https://skmtc.dev/lithic-com/apis/lithic-developer-api/changes/v2/auth_rules/:auth_rule_token/report/get.md)

---

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