Deprecated Fields To Be Removed from Auth Rule Performance Report

Overview

Beginning Wednesday, April 8th, several deprecated fields will be removed from the Auth Rule performance report endpoint (GET /v2/auth_rules/{auth_rule_token}/report). These fields were replaced by the more flexible action_counts and actions fields in March 2026. All customers who have called this endpoint in the last 60 days have been contacted and confirmed no impact.

Details

Fields Being Removed from Daily Statistics

The following fields will be removed from current_version_statistics and draft_version_statistics within each entry in the daily_statistics array:

• approved (integer) - Returns the total number of transactions approved by the rule during the reported period
• declined (integer) - Returns the total number of transactions declined by the rule during the reported period
• challenged (integer) - Returns the total number of transactions challenged by the rule during the reported period

These counts are available through the action_counts object, which provides a mapping of all action types (including APPROVE, DECLINE, CHALLENGE, NO_ACTION, REQUIRE_TFA, and others) to their respective counts.

Example Response

Currently, the statistics object includes both legacy and new fields:

{
  "approved": 150,
  "declined": 30,
  "challenged": 5,
  "action_counts": {
    "APPROVE": 150,
    "DECLINE": 30,
    "CHALLENGE": 5,
    "NO_ACTION": 200
  },
  "examples": [
    {
      "event_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "timestamp": "2026-03-15T10:30:00Z",
      "approved": false,
      "decision": "DECLINED",
      "actions": [{"type": "DECLINE", "code": "AUTH_RULE"}]
    }
  ]
}

After April 8th, the deprecated fields will no longer be present:

{
  "action_counts": {
    "APPROVE": 150,
    "DECLINE": 30,
    "CHALLENGE": 5,
    "NO_ACTION": 200
  },
  "examples": [
    {
      "event_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "timestamp": "2026-03-15T10:30:00Z",
      "actions": [{"type": "DECLINE", "code": "AUTH_RULE"}]
    }
  ]
}

The versions array within daily statistics (added March 2026) will be unaffected, as it has always used action_counts exclusively.

Release Timeline

Production availability: April 8, 2026

User Impact

Integrations that reference the approved, declined, or challenged fields on the performance report response will need to migrate to action_counts. Similarly, integrations reading approved or decision on individual examples should migrate to the actions array. The action_counts field provides broader coverage, including action types such as NO_ACTION, REQUIRE_TFA, and TAG that were not represented by the legacy fields.

Updated Documentation

For the complete Auth Rule performance report specification, visit our API Reference.

If you have any questions or concerns, please contact us via the HELP link in your Lithic Dashboard.

The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.