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

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

Example Response

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