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.