Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.didit.me/llms.txt

Use this file to discover all available pages before exploring further.

Our AML screening process cross-references the user’s information against numerous global watchlists and sanctions databases. This comparison ensures compliance with regulatory requirements and helps identify potential risks. Below is a detailed explanation of the fields you can expect in an AML Screening Report.
Didit AML screening report screenshot with sanctions, PEP and adverse media hits

Report Structure

The verification report is returned as a JSON object containing an aml object with the following key sections:
  • AML Status: Overall screening status and risk level
  • Match Information: Details about potential watchlist matches
  • Scoring Details: Risk scores and match confidence
  • Matched Entity Information: Data about matched entities
  • Verification Metadata: Additional verification details and timestamps

Core Response Fields

interface Properties {
  wikidataId?: string[];
  country?: string[];
  name?: string[];
  topics?: string[];
  gender?: string[];
  modifiedAt?: string[];
  alias?: string[];
  nationality?: string[];
  keywords?: string[];
  position?: string[];
  notes?: string[];
  birthPlace?: string[];
  education?: string[];
  birthDate?: string[];
  firstName?: string[];
  lastName?: string[];
  weakAlias?: string[];
  address?: string[];
  height?: string[];
  ethnicity?: string[];
  eyeColor?: string[];
  hairColor?: string[];
  weight?: string[];
  citizenship?: string[];
  religion?: string[];
  website?: string[];
  title?: string[];
}

interface LinkedEntity {
  name?: string[];
  relation?: string[];
  details?: string[];
  active?: string[];
  status?: string[];
}

interface RiskViewCategory {
  risk_level?: string;
  risk_scores: Record<string, number>;
  score?: number;
  weightage?: number;
}

interface RiskView {
  categories?: RiskViewCategory;
  countries?: RiskViewCategory;
  crimes?: RiskViewCategory;
  custom_list: Record<string, any>;
}

interface AdverseMediaDetails {
  sentiment_score?: number;
  adverse_keywords: Record<string, number>;
  entity_type?: string;
  sentiment?: string;
}

interface AdverseMediaMatch {
  sentiment_score: number; // -1: Slightly Negative, -2: Moderately Negative, -3: Highly Negative
  headline?: string;
  summary?: string;
  source_url?: string;
  other_sources: string[];
  publication_date?: string;
  adverse_keywords: string[];
  thumbnail?: string;
  author_name?: string;
  country?: string;
  sentiment?: string;
}

interface WarningMatch {
  list_name?: string;
  matched_name?: string;
  description?: string;
  publisher?: string;
  source_url?: string;
  other_sources: string[];
  countries?: string[];
  created_at?: string;
  updated_at?: string;
  additional_data: Record<string, any>;
}

interface SanctionMatch {
  list_name?: string[];
  matched_name?: string;
  description?: string;
  reason?: string;
  source_url?: string;
  other_sources: string[];
  details?: string[];
  legal_basis?: string[];
  listed_on?: string[];
  sanction_list?: string[];
  sanction_program?: string[];
  sanctioning_authority?: string[];
  updated_on?: string[];
  additional_data: Record<string, any>;
}

interface PepMatch {
  list_name?: string;
  matched_name?: string;
  description?: string;
  publisher?: string;
  pep_position?: string;
  source_url?: string;
  other_sources: string[];
  date_of_birth?: string;
  place_of_birth?: string;
  aliases: string[];
  education: string[];
}

interface Hit {
  id?: string;
  url?: string;
  match?: boolean;
  score?: number;
  match_score?: number;
  target?: boolean;
  caption?: string;
  datasets?: string[];
  features?: Record<string, any>;
  properties?: Properties;
  rca_name?: string;
  pep_matches: PepMatch[];
  sanction_matches: SanctionMatch[];
  warning_matches: WarningMatch[];
  adverse_media_matches: AdverseMediaMatch[];
  first_seen?: string;
  last_seen?: string;
  linked_entities: LinkedEntity[];
  risk_view?: RiskView;
  additional_information?: Record<string, any>;
  adverse_media_details?: AdverseMediaDetails;
}

interface AMLScreeningResponse {
  aml: {
    status: "Approved" | "Rejected" | "In Review" | "Not Started";
    total_hits: number;
    score: number; // Range: 0-100
    hits: Hit[];
    screened_data: {
      full_name: string;
      nationality: string;
      date_of_birth: string;
      document_number: string;
    };
    warnings: {
      risk: string;
      additional_data: string | null;
      log_type: "information" | "warning" | "error";
      short_description: string;
      long_description: string;
    }[];
  };
}

Sample JSON Response

{
    "aml": {
        "status": "In Review",
        "total_hits": 1,
        "hits": [
            {
                "id": "cPtTGRKkyddAcAC4xgsLCm",
                "url": "https://www.wikidata.org/wiki/Q126539671",
                "match": false,
                "score": 1.0,
                "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.0,
                        "weightage": 20,
                        "risk_level": "Low",
                        "risk_scores": {}
                    },
                    "countries": {
                        "score": 0.0,
                        "weightage": 30,
                        "risk_level": "Low",
                        "risk_scores": {}
                    },
                    "categories": {
                        "score": 100.0,
                        "weightage": 50,
                        "risk_level": "High",
                        "risk_scores": {
                            "PEP": 100.0
                        }
                    },
                    "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.0,
                "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": "1990-01-01",
                        "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,
                        "irregularities": 1,
                        "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": "John Doe",
            "nationality": "USA",
            "date_of_birth": "1990-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."
            }
        ]
    }
}
For more information about potential warnings during the AML screening process, check our AML Screening Warnings guide.