Skip to main content
POST
/
v3
/
aml
AML Screening
curl --request POST \
  --url https://verification.didit.me/v3/aml/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "full_name": "<string>",
  "entity_type": "person",
  "date_of_birth": "2023-12-25",
  "nationality": "<string>",
  "document_number": "<string>",
  "aml_score_approve_threshold": 80,
  "aml_score_review_threshold": 100,
  "aml_name_weight": 60,
  "aml_dob_weight": 25,
  "aml_country_weight": 15,
  "aml_match_score_threshold": 93,
  "include_adverse_media": false,
  "include_ongoing_monitoring": false,
  "save_api_request": true,
  "vendor_data": "<string>"
}
'
{
  "request_id": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
  "aml": {
    "status": "In Review",
    "total_hits": 1,
    "entity_type": "person",
    "hits": [
      {
        "id": "cPtTGRKkyddAcAC4xgsLCm",
        "url": "https://www.wikidata.org/wiki/Q126539671",
        "match": false,
        "score": 1,
        "target": null,
        "caption": "David Sánchez Pérez-Castejón",
        "datasets": [
          "PEP"
        ],
        "features": null,
        "rca_name": "",
        "last_seen": "2025-06-13T00:00:00",
        "risk_view": {
          "crimes": {
            "score": 0,
            "weightage": 20,
            "risk_level": "Low",
            "risk_scores": {}
          },
          "countries": {
            "score": 0,
            "weightage": 30,
            "risk_level": "Low",
            "risk_scores": {}
          },
          "categories": {
            "score": 100,
            "weightage": 50,
            "risk_level": "High",
            "risk_scores": {
              "PEP": 100
            }
          },
          "custom_list": {}
        },
        "first_seen": "2025-01-18T00:00:00",
        "properties": {
          "name": [
            "David Sánchez Pérez-Castejón"
          ],
          "alias": [
            "David Sánchez Pérez-Castejón",
            "David Azagra"
          ],
          "notes": [
            "Spanish orchestra conductor"
          ],
          "title": null,
          "gender": [
            "male"
          ],
          "height": null,
          "topics": null,
          "weight": null,
          "address": null,
          "country": null,
          "website": null,
          "eyeColor": null,
          "keywords": null,
          "lastName": [
            "Sánchez",
            "Pérez-Castejón"
          ],
          "position": null,
          "religion": null,
          "birthDate": [
            "1974"
          ],
          "education": [
            "Tokyo Arts and Space (2012-2012)",
            "Saint Petersburg Conservatory (-2010)",
            "Comillas Pontifical University"
          ],
          "ethnicity": null,
          "firstName": [
            "David"
          ],
          "hairColor": null,
          "weakAlias": null,
          "birthPlace": [
            "Madrid"
          ],
          "modifiedAt": null,
          "wikidataId": null,
          "citizenship": null,
          "nationality": null
        },
        "match_score": 98,
        "risk_score": 73,
        "review_status": "Unreviewed",
        "score_breakdown": {
          "name_score": 95,
          "name_weight": 60,
          "name_weight_normalized": 70.59,
          "name_contribution": 67.06,
          "dob_score": 100,
          "dob_weight": 25,
          "dob_weight_normalized": 29.41,
          "dob_contribution": 29.41,
          "country_score": 0,
          "country_weight": 15,
          "country_weight_normalized": 0,
          "country_contribution": 0,
          "document_number_match_type": "NEUTRAL",
          "document_number_effect": "No document number provided for screening",
          "total_score": 98
        },
        "pep_matches": [
          {
            "aliases": [
              "David Sánchez Pérez-Castejón",
              "David Azagra"
            ],
            "education": [
              "Tokyo Arts and Space (2012-2012)",
              "Saint Petersburg Conservatory (-2010)",
              "Comillas Pontifical University"
            ],
            "list_name": "Wikidata",
            "publisher": "Wikidata",
            "source_url": "https://www.wikidata.org/wiki/Q126539671",
            "description": "Wikidata is the structured data project of the Wikipedia community, providing fact-based information edited by humans and machines",
            "matched_name": "David Sánchez Pérez-Castejón",
            "pep_position": "",
            "date_of_birth": "1974",
            "other_sources": [],
            "place_of_birth": "Madrid"
          }
        ],
        "linked_entities": [
          {
            "name": [
              "Pedro Sánchez"
            ],
            "active": [],
            "status": [],
            "details": [],
            "relation": []
          }
        ],
        "warning_matches": [],
        "sanction_matches": [],
        "adverse_media_details": {
          "sentiment": "Moderately Negative",
          "entity_type": "person",
          "sentiment_score": -2,
          "adverse_keywords": {
            "fraud": 3,
            "juicio": 1,
            "delitos": 2,
            "imputado": 1,
            "impunidad": 1,
            "corruption": 2,
            "favoritism": 2,
            "privilegio": 1,
            "corrupción": 1,
            "persecution": 2,
            "desconfianza": 1,
            "desprestigio": 1,
            "fraude de ley": 2,
            "manipulación": 1,
            "investigación": 3,
            "prevaricación": 8,
            "trato de favor": 1,
            "irregularidades": 2,
            "crisis de confianza": 1,
            "tráfico de influencias": 8
          }
        },
        "adverse_media_matches": [
          {
            "country": "spain",
            "summary": "David Sánchez is implicated in legal violations related to favoritism and influence trafficking, leading to a negative portrayal in the article.",
            "headline": "La Diputación de Badajoz consolida la plaza a medida para el ex asesor de Moncloa amigo del \"hermanito\" de Sánchez",
            "sentiment": "moderately negative",
            "thumbnail": "https://phantom-elmundo.uecdn.es/cc1a93b3dc34de90978255ac2f0bc64a/crop/0x28/755x531/f/webp/assets/multimedia/imagenes/2025/06/10/17495802073838.jpg",
            "source_url": "https://www.elmundo.es/espana/extremadura/2025/06/10/68486e41e9cf4aff318b4584.html#ancla_comentarios",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "fraud",
              "prevaricación",
              "tráfico de influencias",
              "irregularidades",
              "imputado"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-10T20:46:38"
          },
          {
            "country": "spain",
            "summary": "David Sánchez is implicated in legal issues regarding favoritism and corruption, leading to a negative portrayal in the article.",
            "headline": "La Diputación de Badajoz consolida la plaza a medida para el ex asesor de Moncloa amigo del \"hermanito\" de Sánchez",
            "sentiment": "moderately negative",
            "thumbnail": "https://phantom-elmundo.uecdn.es/cc1a93b3dc34de90978255ac2f0bc64a/crop/0x28/755x531/f/webp/assets/multimedia/imagenes/2025/06/10/17495802073838.jpg",
            "source_url": "https://www.elmundo.es/espana/extremadura/2025/06/10/68486e41e9cf4aff318b4584.html",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "fraud",
              "prevaricación",
              "tráfico de influencias",
              "irregularidades",
              "trato de favor"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-10T20:46:38"
          },
          {
            "country": "spain",
            "summary": "David Sánchez Pérez-Castejón is mentioned in connection with Miguel Ángel Gallardo's corruption case, indicating his involvement in alleged influence peddling.",
            "headline": "España, paraíso del aforado",
            "sentiment": "moderately negative",
            "thumbnail": "https://eladelantado.com/wp-content/uploads/2020/07/EMILIO-MONTERO.jpg",
            "source_url": "https://eladelantado.com/opinion/tribuna/espana-paraiso-del-aforado/",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "prevaricación",
              "tráfico de influencias",
              "corrupción",
              "impunidad",
              "privilegio",
              "desconfianza",
              "manipulación",
              "fraude de ley"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-10T05:05:34"
          },
          {
            "country": "spain",
            "summary": "David Sánchez Pérez-Castejón is implicated in the same investigation as Gallardo, which raises questions about his conduct and political ethics.",
            "headline": "Aforamientos: esa figura incómoda",
            "sentiment": "moderately negative",
            "thumbnail": "https://estaticos-cdn.prensaiberica.es/clip/8eac61b9-2840-4449-bed4-90d9f725b2fe_16-9-discover-aspect-ratio_default_0.jpg",
            "source_url": "https://www.laprovincia.es/opinion/20250608/aforamientos-figura-incomoda-118362206.html",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "prevaricación",
              "tráfico de influencias",
              "investigación",
              "juicio",
              "fraude de ley",
              "desprestigio",
              "crisis de confianza",
              "delitos"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-08T06:01:00"
          },
          {
            "country": "spain",
            "summary": "David Sánchez is implicated in a legal investigation regarding irregularities in his hiring, which raises serious concerns about his conduct.",
            "headline": "La jueza del 'caso David Sánchez' denuncia un «fraude de ley» en el aforamiento de Gallardo (PSOE)",
            "sentiment": "moderately negative",
            "thumbnail": "https://www.periodistadigital.com/wp-content/uploads/2025/05/MIGUELANGELGALLARDOPSOE.jpeg",
            "source_url": "https://www.periodistadigital.com/politica/parlamento/20250609/jueza-caso-david-sanchez-denuncia-fraude-ley-aforamiento-gallardo-psoe-noticia-689405098733/",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "fraud",
              "irregularities",
              "prevaricación",
              "tráfico de influencias"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-09T10:19:10"
          },
          {
            "country": "spain",
            "summary": "David Sánchez Pérez-Castejón is mentioned in connection with legal allegations of corruption, contributing to a negative perception.",
            "headline": "'Caso aforamiento': la letrada mayor de la Asamblea certifica a la juez que Gallardo es diputado desde antes de prometer su cargo en el Pleno",
            "sentiment": "moderately negative",
            "thumbnail": "https://phantom-elmundo.uecdn.es/cdfe952e2eb32d418a246ef5eb9be3e3/crop/90x60/3072x2048/resize/1200/f/webp/assets/multimedia/imagenes/2025/06/09/17494564540210.jpg",
            "source_url": "https://www.elmundo.es/espana/extremadura/2025/06/09/6846967921efa0ce1d8b45a4.html",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "prevaricación",
              "tráfico de influencias"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-09T08:08:30"
          },
          {
            "country": "spain",
            "summary": "David Sánchez Pérez-Castejón is implicated in the same investigation as Gallardo, raising concerns about political corruption and influence.",
            "headline": "Aforamientos: esa figura incómoda",
            "sentiment": "moderately negative",
            "thumbnail": "https://estaticos-cdn.prensaiberica.es/clip/8eac61b9-2840-4449-bed4-90d9f725b2fe_16-9-discover-aspect-ratio_default_0.jpg",
            "source_url": "https://www.laprovincia.es/opinion/2025/06/08/aforamientos-figura-incomoda-118362206.html",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "prevaricación",
              "tráfico de influencias",
              "investigación"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-08T06:01:00"
          },
          {
            "country": "spain",
            "summary": "David Sánchez Pérez-Castejón is implicated in the same investigation as Gallardo, which raises concerns about political misconduct.",
            "headline": "Aforamientos: esa figura incómoda",
            "sentiment": "moderately negative",
            "thumbnail": "https://estaticos-cdn.prensaiberica.es/clip/8eac61b9-2840-4449-bed4-90d9f725b2fe_16-9-discover-aspect-ratio_default_0.jpg",
            "source_url": "https://www.eldia.es/opinion/2025/06/08/aforamientos-figura-incomoda-118361478.html",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "prevaricación",
              "tráfico de influencias",
              "investigación",
              "delitos"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-08T06:00:59"
          },
          {
            "country": "spain",
            "summary": "David Sánchez is implicated in a case of favoritism and corruption, which casts a negative light on his character and actions.",
            "headline": "'Caso David Sánchez': las asociaciones judiciales salen en defensa de la juez Beatriz Biedma ante las \"presiones externas\" que sufre",
            "sentiment": "moderately negative",
            "thumbnail": "https://phantom-elmundo.uecdn.es/be126dc17613b0ba543ad59c7d492e07/crop/2x0/1842x1227/resize/1200/f/webp/assets/multimedia/imagenes/2025/06/06/17491963870306.jpg",
            "source_url": "https://www.elmundo.es/espana/extremadura/2025/06/06/68429e1cfc6c8377048b4578.html",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "favoritism",
              "corruption",
              "persecution"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-06T10:08:15"
          },
          {
            "country": "spain",
            "summary": "David Sánchez is implicated in a case of alleged favoritism and corruption, which casts a negative light on his character and actions.",
            "headline": "'Caso David Sánchez': las asociaciones judiciales salen en defensa de la juez Beatriz Biedma ante las \"presiones externas\" que sufre",
            "sentiment": "moderately negative",
            "thumbnail": "https://phantom-elmundo.uecdn.es/be126dc17613b0ba543ad59c7d492e07/crop/2x0/1842x1227/resize/1200/f/webp/assets/multimedia/imagenes/2025/06/06/17491963870306.jpg",
            "source_url": "https://www.elmundo.es/espana/extremadura/2025/06/06/68429e1cfc6c8377048b4578.html#ancla_comentarios",
            "author_name": null,
            "other_sources": [],
            "adverse_keywords": [
              "favoritism",
              "corruption",
              "persecution"
            ],
            "sentiment_score": -2,
            "publication_date": "2025-06-06T08:08:15"
          }
        ],
        "additional_information": {}
      }
    ],
    "score": 80,
    "screened_data": {
      "full_name": "David Sánchez Pérez-Castejón",
      "nationality": "ES",
      "date_of_birth": "1974-01-01",
      "document_number": null
    },
    "warnings": [
      {
        "risk": "POSSIBLE_MATCH_FOUND",
        "additional_data": null,
        "log_type": "warning",
        "short_description": "Possible match found in AML screening",
        "long_description": "The Anti-Money Laundering (AML) screening process identified potential matches with watchlists or high-risk databases, requiring further review."
      }
    ]
  },
  "created_at": "2025-05-01T13:11:07.977806Z"
}

Authorizations

​
x-api-key
string
header
required

Body

application/json
​
full_name
string
required

Full name of the person or company to be screened.

​
entity_type
enum<string>
default:person

Type of entity to screen. Either 'person' or 'company'. Defaults to 'person'.

Available options:
person,
company
​
date_of_birth
string<date>

Date of birth for persons or incorporation date for companies, with format: YYYY-MM-DD. For example, 1990-05-15.

​
nationality
string

Nationality of the person to be screened with format ISO 3166-1 alpha-2. For example: ES. Only applicable for person entity type.

​
document_number
string

Document number of the person to be screened. Only applicable for person entity type.

​
aml_score_approve_threshold
number
default:80

Score threshold below which hits are auto-approved (0-100). Hits with match scores below this threshold will be marked as approved. Default: 86.

Required range: 0 <= x <= 100
​
aml_score_review_threshold
number
default:100

Score threshold above which hits are auto-declined (0-100). Hits with match scores above this threshold will be declined. Scores between approve and review thresholds require manual review. Default: 100.

Required range: 0 <= x <= 100
​
aml_name_weight
integer
default:60

Weight for name similarity in match score calculation (0-100). The sum of aml_name_weight + aml_dob_weight + aml_country_weight must equal 100. Default: 60.

Required range: 0 <= x <= 100
​
aml_dob_weight
integer
default:25

Weight for date of birth in match score calculation (0-100). The sum of aml_name_weight + aml_dob_weight + aml_country_weight must equal 100. Default: 25.

Required range: 0 <= x <= 100
​
aml_country_weight
integer
default:15

Weight for country/nationality in match score calculation (0-100). The sum of aml_name_weight + aml_dob_weight + aml_country_weight must equal 100. Default: 15.

Required range: 0 <= x <= 100
​
aml_match_score_threshold
integer
default:93

Match score threshold (0-100) that determines if a hit is a False Positive or Unreviewed (Possible Match). Hits with match_score below this are marked as 'False Positive' and excluded from risk assessment. Hits at or above are 'Unreviewed' (Possible Match). Default: 93.

Required range: 0 <= x <= 100
​
include_adverse_media
boolean
default:false

Wheter to include adverse media in the screening. If included, the request will take approximately 10 seconds.

​
include_ongoing_monitoring
boolean
default:false

Whether to include ongoing monitoring in the screening. If included, the save_api_request must be included as well, otherwise it will raise an error.

​
save_api_request
boolean
default:true

Whether to save this API request. If true, then it will appear on the Manual Checks section in the Business Console.

​
vendor_data
string

A unique identifier for the vendor or user, such as a UUID or email. This field enables proper session tracking and user data aggregation across multiple verification sessions.

Response

​
request_id
string<uuid>
​
aml
object
​
created_at
string<date-time>