# Auth Rule Performance Report

## Auth Rule Token

- **uuid**: required
- **begin**: required (Start date for the report)
- **end**: required (End date for the report)

## Response Structure

### ``200 Auth Rule Performance Report``

- **auth_rule_token**: uuid (required)  
- **begin**: date (required) - The start date (UTC) of the report.  
- **end**: date (required) - The end date (UTC) of the report.  
- **daily_statistics**: array of objects (required) - Daily evaluation statistics for the Auth Rule.

#### daily_statistics*

- **object**  
  - **date**: date (required) - The date (UTC) for which the statistics are reported.  
  - **versions**: array of objects (required) - Statistics for each version of the rule that was evaluated during the reported day.

##### versions*

- **object**  
  - **version**: integer (required) - The rule version number.  
  - **state**: string (enum, required) - The evaluation mode of this version during the reported period.  
  - **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.

###### action_counts object

- **examples**: array of objects (required) - Example events and their outcomes for this version.

###### examples*

- **object**  
  - **event_token**: uuid (required) - The event token.  
  - **transaction_token**: uuid | null - The token of the transaction associated with the event.  
  - **timestamp**: date-time (required) - The timestamp of the event.  
  - **actions**: array (required) - The actions taken by this version for this event.

#### actions*

- **Authorization Action (Result)**  
- **Authentication (3DS) Action (Result)**  
- **Tokenization Action**  
- **ACH Action**  
- **Decline Action (Authorization)**  
- **Challenge Action (Authorization)**

##### action object

- **type**: string (enum, required) - `DECLINE`  
- **code**: string (enum, required) - The detailed result code explaining the specific reason for the decline.

## Error Responses

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

## Example Query

```shell
curl --request GET \
     --url https://sandbox.lithic.com/v2/auth_rules/auth_rule_token/report \
     --header 'accept: application/json'
```

## Example Response

```json
{
  "auth_rule_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "begin": "2026-07-18",
  "end": "2026-07-18",
  "daily_statistics": [
    {
      "date": "2026-07-18",
      "versions": [
        {
          "version": 0,
          "state": "ACTIVE",
          "action_counts": {
            "additionalProp": 0
          },
          "examples": [
            {
              "event_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
              "transaction_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
              "timestamp": "2026-07-18T03:11:45.938Z",
              "actions": [
                {
                  "type": "DECLINE",
                  "code": "APPROVED"
                },
                {
                  "type": "DECLINE"
                },
                {
                  "type": "DECLINE",
                  "reason": "ACCOUNT_SCORE_1"
                },
                {
                  "type": "APPROVE"
                }
              ]
            }
          ]
        }
      ]
    }
  ]
}
```