Everything you need to integrate Naiza fraud detection and AML screening APIs into your application.
Overview
Naiza provides a RESTful JSON API for real-time fraud detection. Submit events with customer, device, and session context to receive instant ALLOW / BLOCK / REVIEW decisions with risk scores and matched rules.
Base URL: https://api.naiza.ai/api/v1
Authentication uses the x-api-key header with keys formatted as naiza_api_sk_live_... or naiza_api_sk_test_...
Decision Types
- ALLOW — No fraud signals detected; proceed normally
- REVIEW — Suspicious indicators found; require additional verification
- BLOCK — High-confidence fraud detected; deny access immediately
Risk Score
Risk scores accumulate from SCORE-type rules during evaluation. A score of 100 or above triggers a REVIEW decision.
- 0-25 Low — Normal behavior, minimal fraud indicators
- 26-50 Medium — Some suspicious indicators present
- 51-75 High — Multiple fraud indicators detected
- 76-100+ Critical — Strong fraud signals; score >= 100 triggers REVIEW
Rate Limits
Default quota is 10,000 req/hr on a 1 hour rolling window. Exceeding the limit returns HTTP 429 with a Retry-After header.
Response time
Use the observed duration field in responses to track request processing time and monitor your integration.
Guides and API Reference
Interactive documentation covers Getting Started, Tenant Onboarding, Web SDK, Quick Start, Event Monitoring, AML Integration, Integration Examples, API Reference, Code Examples, and Best Practices. Each guide has a unique URL such as /docs/guides/getting-started and /docs/api-reference/events.