improved

June 24, 2025

Auth Rule Performance Reports Are Now Available On-Demand
Release date: June 24, 2025
Impact: Daily Auth Rule performance reports can now be retrieved immediately
Audience: All customers using Auth Rules
Action required: Update integrations to use the new retrieval endpoint
Products affected: Auth Rules APIs

Overview

Daily performance reports for auth rules are now available immediately through a single API call. Previously, customers had to request report generation and wait for processing. Now, reports are automatically calculated daily and can be retrieved on-demand. Performance reports are available for up to 3 months of historical data with a maximum interval of 1 month. Daily intervals are measured from 00:00:00 - 23:59:59 UTC.

Details

The new GET /v2/auth_rules/{auth_rule_token}/report endpoint replaces the previous two-step request and retrieval workflow:

  • Before: POST to request → Wait → GET to retrieve
  • Now: Single GET request returns performance data immediately

Example: Retrieving a Performance Report

GET /v2/auth_rules/{auth_rule_token}/report?begin=2025-06-01&end=2025-06-23

Returns daily statistics for both current and draft rule versions, including approval/decline/challenge counts and sample events.

{
  "auth_rule_token": "7b23c4d5-e6f7-8901-2345-6789abcdef01",
  "begin": "2025-06-01",
  "end": "2025-06-23",
  "daily_statistics": [
    {
      "date": "2025-06-01",
      "current_version_statistics": {
        "version": 1,
        "approved": 1543,
        "declined": 87,
        "challenged": 23,
        "examples": [...]
      },
      "draft_version_statistics": null
    },
    {
      "date": "2025-06-02",
      "current_version_statistics": {
        "version": 1,
        "approved": 1627,
        "declined": 92,
        "challenged": 18,
        "examples": [...]
      },
      "draft_version_statistics": null
    }
  ]
}

User Impact

Customer integrations which retrieve reports using the previous asynchronous process must be updated. The endpoint to request a performance report calculation, which was used in the old flow, has been deprecated and will be removed in a future version of the API.

Updated Documentation

Visit our API Reference for details.

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


The Lithic changelog has an RSS feed! Subscribe with your preferred RSS reader.