Inizia
Integrazione / SDK
Verifica degli utenti
Verifica aziendale
Monitoraggio delle transazioni
Changelogcurl -X POST https://verification.didit.me/v3/aml/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: aml-user-1234-2026-08-20' \
-d '{
"full_name": "Antonio Ejemplo Modelo",
"entity_type": "person",
"date_of_birth": "1972-02-29",
"nationality": "ES",
"include_adverse_media": false,
"vendor_data": "user-1234"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.aml.screen(
full_name="Antonio Ejemplo Modelo",
entity_type="person",
date_of_birth="1972-02-29",
nationality="ES",
include_adverse_media=False,
vendor_data="user-1234",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.aml.screen({
full_name: "Antonio Ejemplo Modelo",
entity_type: "person",
date_of_birth: "1972-02-29",
nationality: "ES",
include_adverse_media: false,
vendor_data: "user-1234",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.AML.Screen(ctx, didit.AMLScreenParams{
FullName: "Antonio Ejemplo Modelo",
EntityType: didit.Some(didit.AMLScreenParamsEntityType("person")),
DateOfBirth: didit.String("1972-02-29"),
Nationality: didit.String("ES"),
IncludeAdverseMedia: didit.Bool(false),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.time.LocalDate;
import me.didit.Didit;
import me.didit.types.AmlScreenParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.aml().screen(AmlScreenParams.builder()
.fullName("Antonio Ejemplo Modelo")
.entityType(AmlScreenParams.EntityType.of("person"))
.dateOfBirth(LocalDate.parse("1972-02-29"))
.nationality("ES")
.includeAdverseMedia(false)
.vendorData("user-1234")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->aml->screen([
'full_name' => 'Antonio Ejemplo Modelo',
'entity_type' => 'person',
'date_of_birth' => '1972-02-29',
'nationality' => 'ES',
'include_adverse_media' => false,
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.aml.screen(
full_name: "Antonio Ejemplo Modelo",
entity_type: "person",
date_of_birth: "1972-02-29",
nationality: "ES",
include_adverse_media: false,
vendor_data: "user-1234"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Aml.ScreenAsync(new AmlScreenParams
{
FullName = "Antonio Ejemplo Modelo",
EntityType = new AmlScreenParamsEntityType("person"),
DateOfBirth = "1972-02-29",
Nationality = "ES",
IncludeAdverseMedia = false,
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"request_id": "d27c5509-7a66-45a9-b05e-d69d9f4c336a",
"aml": {
"status": "Approved",
"total_hits": 0,
"entity_type": "person",
"hits": [],
"score": 0,
"screened_data": {
"full_name": "Maximilian Mustermann-Doe",
"date_of_birth": "1992-03-14",
"nationality": "DE",
"document_number": null
},
"warnings": []
},
"vendor_data": "user-1234",
"metadata": {
"internal_ref": "abc-123"
},
"created_at": "2026-06-11T10:21:07.013938+00:00"
}Screening AML API: Sanzioni, PEP e Watchlist
Screening AML in tempo reale su 1,300+ watchlist globali con Didit: sanzioni, PEP, notizie negative. $0.20 a controllo, nessun minimo mensile.
curl -X POST https://verification.didit.me/v3/aml/ \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: aml-user-1234-2026-08-20' \
-d '{
"full_name": "Antonio Ejemplo Modelo",
"entity_type": "person",
"date_of_birth": "1972-02-29",
"nationality": "ES",
"include_adverse_media": false,
"vendor_data": "user-1234"
}'from didit import Didit
# Reads DIDIT_API_KEY.
client = Didit()
result = client.aml.screen(
full_name="Antonio Ejemplo Modelo",
entity_type="person",
date_of_birth="1972-02-29",
nationality="ES",
include_adverse_media=False,
vendor_data="user-1234",
)
print(result)import Didit from "@didit-protocol/sdk-node";
// Reads DIDIT_API_KEY.
const didit = new Didit();
const result = await didit.aml.screen({
full_name: "Antonio Ejemplo Modelo",
entity_type: "person",
date_of_birth: "1972-02-29",
nationality: "ES",
include_adverse_media: false,
vendor_data: "user-1234",
});
console.log(result);ctx := context.Background()
// Reads DIDIT_API_KEY.
client := didit.NewClient()
result, err := client.AML.Screen(ctx, didit.AMLScreenParams{
FullName: "Antonio Ejemplo Modelo",
EntityType: didit.Some(didit.AMLScreenParamsEntityType("person")),
DateOfBirth: didit.String("1972-02-29"),
Nationality: didit.String("ES"),
IncludeAdverseMedia: didit.Bool(false),
VendorData: didit.String("user-1234"),
})
if err != nil {
log.Fatal(err)
}
fmt.Printf("%+v\n", result)import java.time.LocalDate;
import me.didit.Didit;
import me.didit.types.AmlScreenParams;
// Reads DIDIT_API_KEY.
Didit client = new Didit();
var result = client.aml().screen(AmlScreenParams.builder()
.fullName("Antonio Ejemplo Modelo")
.entityType(AmlScreenParams.EntityType.of("person"))
.dateOfBirth(LocalDate.parse("1972-02-29"))
.nationality("ES")
.includeAdverseMedia(false)
.vendorData("user-1234")
.build());
System.out.println(result);<?php
require 'vendor/autoload.php';
use Didit\DiditClient;
// Reads DIDIT_API_KEY.
$didit = new DiditClient();
$result = $didit->aml->screen([
'full_name' => 'Antonio Ejemplo Modelo',
'entity_type' => 'person',
'date_of_birth' => '1972-02-29',
'nationality' => 'ES',
'include_adverse_media' => false,
'vendor_data' => 'user-1234',
]);
print_r($result->toArray());require "didit"
# Reads DIDIT_API_KEY.
didit = Didit::Client.new
result = didit.aml.screen(
full_name: "Antonio Ejemplo Modelo",
entity_type: "person",
date_of_birth: "1972-02-29",
nationality: "ES",
include_adverse_media: false,
vendor_data: "user-1234"
)
puts result.to_husing System;
using System.Text.Json;
using Didit;
// Reads DIDIT_API_KEY.
using var client = new DiditClient();
var result = await client.Aml.ScreenAsync(new AmlScreenParams
{
FullName = "Antonio Ejemplo Modelo",
EntityType = new AmlScreenParamsEntityType("person"),
DateOfBirth = "1972-02-29",
Nationality = "ES",
IncludeAdverseMedia = false,
VendorData = "user-1234",
});
Console.WriteLine(JsonSerializer.Serialize(result));{
"request_id": "d27c5509-7a66-45a9-b05e-d69d9f4c336a",
"aml": {
"status": "Approved",
"total_hits": 0,
"entity_type": "person",
"hits": [],
"score": 0,
"screened_data": {
"full_name": "Maximilian Mustermann-Doe",
"date_of_birth": "1992-03-14",
"nationality": "DE",
"document_number": null
},
"warnings": []
},
"vendor_data": "user-1234",
"metadata": {
"internal_ref": "abc-123"
},
"created_at": "2026-06-11T10:21:07.013938+00:00"
}Autorizzazioni
La chiave API della tua applicazione, da Developers -> API keys nella Business Console. La chiave primaria ha accesso completo. Una chiave con nome può avere un ambito definito: nessuno, lettura o scrittura per risorsa, limitata ad alcuni workflow o a sessioni approvate, a un elenco di indirizzi IP e a una data di scadenza. 401 indica che la chiave è errata, revocata o scaduta; 403 indica che non è stata inviata alcuna chiave, che la chiave non ha accesso a questa risorsa o azione, oppure che la richiesta proviene da un indirizzo non incluso nel suo elenco IP; 404 su una route di sessione indica che la sessione non rientra nei workflow o negli stati previsti dalla chiave. Una chiave senza accesso ai media riceve gli URL di immagini, video e PDF come null, e una chiave senza permessi di scrittura sulle sessioni riceve link e token di sessione come null. Consulta https://docs.didit.me/console/api-keys.
Intestazioni
Chiave opzionale di sicurezza per i nuovi tentativi, fino a 255 caratteri. Riutilizzare la stessa chiave con lo stesso corpo della richiesta restituisce la risposta originale senza eseguire né fatturare un secondo screening. Riutilizzare la chiave con un corpo diverso restituisce 409.
255Corpo
Nome completo della persona o azienda da sottoporre a screening. Minimo 2 caratteri (limite minimo imposto dal fornitore di screening). Un nome più corto o vuoto restituisce 400 su questo campo prima che venga eseguito qualsiasi screening, quindi non viene addebitato alcun costo.
2"Antonio Ejemplo Modelo"
Tipo di entità da sottoporre a screening. Il valore predefinito è person.
person, company Data di nascita (persone) o data di costituzione (aziende), YYYY-MM-DD. Migliora la precisione della corrispondenza tramite il peso della data di nascita.
"1972-02-29"
Codice paese ISO 3166-1 alpha-2 (ad es. ES). I codici non validi restituiscono 400. Migliora la precisione della corrispondenza tramite il peso del paese.
"ES"
Numero del documento d'identità. Non ponderato — funge da chiave di riferimento: una corrispondenza esatta sovrascrive il match_score del riscontro portandolo a 100, mentre una netta mancata corrispondenza lo penalizza. Inviato al fornitore di screening come filtro di ricerca solo quando è di 2-50 caratteri; un valore al di fuori di questo intervallo viene accettato e memorizzato, e lo screening viene comunque eseguito e fatturato, semplicemente senza restrizione per numero di documento.
Soglia del punteggio di rischio pari o inferiore alla quale il risultato è Approved. Deve essere ≤ aml_score_review_threshold (altrimenti 400).
0 <= x <= 100Soglia del punteggio di rischio al di sopra della quale il risultato è Declined. I punteggi compresi tra le due soglie generano In Review.
0 <= x <= 100Peso della somiglianza del nome nel punteggio di corrispondenza per singola occorrenza. I tre pesi devono dare come somma esattamente 100 (altrimenti 400).
0 <= x <= 100Peso della data di nascita nel punteggio di corrispondenza per singola occorrenza.
0 <= x <= 100Peso del paese/nazionalità nel punteggio di corrispondenza per singola occorrenza.
0 <= x <= 100Soglia per hit: gli hit con match_score inferiore a questo valore sono False Positive (esclusi dalla valutazione del rischio); quelli pari o superiori sono possibili corrispondenze Unreviewed.
0 <= x <= 100Cerca anche notizie negative sui media. Aggiunge fino a ~30 s di latenza durante la raccolta dei risultati; utilizza un timeout del client ≥60 s.
Continua a eseguire lo screening periodico di questo profilo e invia le modifiche tramite webhook. Richiede save_api_request=true (altrimenti 400).
Salva lo screening come sessione (visibilità nella console, endpoint della decisione, webhook, revisione dei riscontri). Imposta su false per un controllo senza stato.
Il tuo identificatore per l'utente sottoposto a screening; restituito nella risposta e memorizzato con la sessione.
JSON a struttura libera memorizzato con la richiesta e restituito nella risposta.
Slug dello scenario solo per sandbox. Accettato solo quando la chiave API appartiene a un'applicazione in modalità sandbox; rifiutato nelle applicazioni di produzione. Uno screening autonomo non ha una sessione da preparare, quindi lo slug va inserito direttamente nella richiesta di screening: decline_aml_hit restituisce una corrispondenza con struttura identica a quella di produzione e conclude lo screening come Declined, review_aml_possible_match lo conclude come In Review, mentre uno scenario che non imposta alcun esito AML lascia lo screening pulito. Consulta il catalogo degli scenari su GET /v1/sandbox/scenarios/ o Sandbox & Test Data.
"decline_aml_hit"
Risposta
Screening completato. aml.status riflette le tue soglie; ogni hit pari o superiore alla soglia minima interna di inclusione è elencato in aml.hits con il relativo match_score di identità, risk_score dell'entità e uno score_breakdown che spiega la corrispondenza.
ID della sessione salvata quando save_api_request=true (utilizzabile con GET /v3/session/{sessionId}/decision/); altrimenti un UUID di correlazione temporaneo.
Show child attributes
Show child attributes
Eco del vendor_data inviato.
Eco del metadata inviato.