Get Rule
API Reference
Get Rule
Retrieve details of a specific rule by ID β in the gu1 rules engine for compliance and risk detection, with examples for get use cases.
GET
Get Rule
Overview
Retrieves complete information about a specific rule, including its conditions, actions, execution statistics, and version history.Endpoint
Authentication
Requires a valid API key in the Authorization header:Path Parameters
UUID of the rule to retrieve
Response
UUID of the rule
Your organization ID
Rule name
Rule description
Rule category (kyc, kyb, aml, fraud, compliance, custom)
Current status (draft, active, shadow, archived, inactive)
Whether the rule is enabled
Rule priority (1-100)
Risk score assigned when rule matches
Complete condition structure with nested logic
JSON string representation of conditions (for storage)
Array of actions to execute when rule matches
Rule scope configuration (countries, entity types, temporal windows)
Array of entity types the rule applies to
Evaluation mode (sync or async)
Associated risk matrix UUID (if any)
Current version number
UUID of the previous version (if any)
Array of tags for organization
Execution statistics (executions, successes, failures)
User ID who created the rule
ISO timestamp of creation
User ID who last updated the rule
ISO timestamp of last update
Example Requests
Response Example
Error Responses
404 Not Found
401 Unauthorized
403 Forbidden
Use Cases
Display Rule Details in UI
Monitor Rule Performance
Clone Rule Configuration
Export Rule Configuration
Best Practices
- Cache Rule Data: Cache frequently accessed rules to reduce API calls
- Monitor Statistics: Regularly check
statsobject for performance insights - Track Versions: Use
versionandpreviousVersionIdfor audit trails - Check Status: Always verify
enabledandstatusbefore execution - Use Tags: Leverage tags for organization and filtering
See Also
- List Rules - Query and filter rules
- Update Rule - Modify rule configuration
- Execute Rule - Test rule against entities
- Create Rule - Create new rules