Preview FIA threshold-reporting sweep (dry-run counts)
GET/reports/regulator/fia/sweep
Runs the daily AML sweep and returns the counts that would be reported (CTR ≥ UGX 20M and 12-month aggregations ≥ UGX 50M per beneficiary). Thresholds are set via FIA_CTR_THRESHOLD_UGX and FIA_AGGREGATE_THRESHOLD_UGX. See docs/design/payment-gateway-review.md.
Request
Responses
- 200
- 401
- 403
- 429
- 500
Missing, malformed, or expired authentication token. Log in via POST /auth/login (or refresh via POST /auth/refresh) and retry with a fresh Authorization: Bearer <accessToken> header.
The authenticated caller does not carry the required permission or is scoped out of this resource by the object-authorization service (e.g. an agent trying to view another agent's referrals). Grant the missing permission via a role change or scope the query to resources the caller owns.
Rate limit exceeded. Global default is 120 requests/minute per IP; auth-flow, OTP, self-registration, WebAuthn, IRA lookup, and public-lead endpoints carry tighter per-endpoint limits. Retry after the delay indicated by the Retry-After header.
Response Headers
Seconds to wait before retrying.
Unhandled server error. The response carries a meta.requestId correlator you can hand to platform operations to trace the failure through structured logs and the hash-chained audit trail. Retry with the same Idempotency-Key header if the endpoint accepts idempotency.