Didit AML Screening API

Overview

Screens a person or company against 1,300+ global watchlists and databases in one synchronous call. Two scores per hit: Match Score (is this the same person?) and Risk Score (how risky is the matched entity?).

Key constraints:

• full_name is the only required field (at least 2 characters).
• entity_type: "person" (default) or "company".
• nationality is an ISO 3166-1 alpha-2 code (ES, not ESP). Anything else returns 400.
• aml_name_weight + aml_dob_weight + aml_country_weight must sum to exactly 100.
• aml_score_approve_threshold must be <= aml_score_review_threshold.
• include_ongoing_monitoring: true requires save_api_request: true (the default).
• include_adverse_media: true waits for adverse media (about 5 s plus up to 25 s): use a client timeout of at least 60 seconds.
• Send an Idempotency-Key header when retrying, so a timeout never runs or bills a second screening.

Coverage (per the docs): sanctions (e.g. OFAC SDN, UN, EU, HM Treasury), law-enforcement and most-wanted lists (e.g. FBI, Interpol), PEPs (Levels 1-4) and their relatives and close associates, warnings and regulatory enforcement, fitness and probity, insolvency, and adverse media from 50k+ news sources (only with include_adverse_media: true).