Rule Evaluation Results Available via API

Overview

Beginning Tuesday, February 10th, a new GET /v2/auth_rules/results endpoint will be available in the Auth Rules API. This endpoint returns detailed evaluation results showing exactly which rules were evaluated against specific events, what actions those rules produced, and why. Card programs can use these results to debug rule behavior, validate rule changes across versions, and monitor both active and inactive rules.

Details

Endpoint

GET /v2/auth_rules/results

Query Parameters

• event_token (UUID, optional) - Filter results to evaluations triggered by a specific event
• auth_rule_token (UUID, optional) - Filter results to evaluations of a specific auth rule
• has_actions (boolean, optional) - Filter by whether the evaluation produced any actions. When omitted, all results are returned
• starting_after (optional) - Cursor for forward pagination
• ending_before (optional) - Cursor for backward pagination
• page_size (optional) - Number of results per page

At least one of event_uuid or auth_rule_token must be provided. Pagination is not supported when filtering by event_uuid. Results are available for the past 3 months.

Response Object: Auth Rule Result

Each result in the response contains:

• token (UUID) - Unique identifier for this evaluation instance
• auth_rule_token (UUID) - The auth rule that was evaluated
• event_token (UUID) - The event that triggered the evaluation
• evaluation_time (datetime) - Timestamp of when the evaluation occurred
• rule_version (integer) - Version number of the rule at the time of evaluation
• mode (enum: ACTIVE, INACTIVE) - Whether the rule was actively affecting traffic or in an inactive/shadow state during evaluation
• event_stream (enum) - The event stream during which the rule was evaluated (e.g., AUTHORIZATION, THREE_DS_AUTHENTICATION, TOKENIZATION, ACH)
• actions (array) - The actions the rule produced (or would have produced in shadow mode), each containing an action type appropriate to the event stream and an optional explanation field describing why the action was taken

SDK Access

The endpoint is available in all Lithic SDKs (TypeScript, Python, Java, Kotlin, Go, Ruby) under auth_rules.v2.list_results.

Release Timeline

• Production availability: February 10, 2026

📘

Rule results will not be backfilled to previous transactions; transactions prior to February 2026 will not have rule results available

User Impact

This change is additive only. Existing integrations will continue to function without modification.

Updated Documentation

Updated API documentation for this endpoint will be published alongside the release.

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