Erste Schritte
Integrieren / SDKs
Benutzerverifizierung
Unternehmensverifizierung
Transaktionsüberwachung
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"
}AML-Screening-API: Sanktionen, PEP & Watchlists
Echtzeit-AML-Screening mit Didit: 1,300+ Watchlists, Sanktionen, PEP, negative Medien. Zwei Risiko-Scores, $0.20/Check, keine Monatsminima.
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"
}Autorisierungen
Der API-Schlüssel Ihrer Anwendung, aus Entwickler -> API-Schlüssel in der Business Console. Der Primärschlüssel hat Vollzugriff. Ein benannter Schlüssel kann im Geltungsbereich eingeschränkt werden: keine, Lese- oder Schreibberechtigung pro Ressource, beschränkt auf bestimmte Workflows oder genehmigte Sitzungen, auf eine Liste von IP-Adressen und auf ein Ablaufdatum. 401 bedeutet, dass der Schlüssel falsch, widerrufen oder abgelaufen ist; 403 bedeutet, dass kein Schlüssel gesendet wurde, der Schlüssel keinen Zugriff auf diese Ressource oder Aktion hat oder die Anfrage von einer Adresse außerhalb seiner IP-Liste stammte; 404 bei einer Sitzungsroute bedeutet, dass die Sitzung außerhalb der Workflows oder Status des Schlüssels liegt. Ein Schlüssel ohne Medienzugriff erhält Bild-, Video- und PDF-URLs als null, und ein Schlüssel ohne Schreibberechtigung für Sitzungen erhält Sitzungslinks und Token als null. Siehe https://docs.didit.me/console/api-keys.
Header
Optionaler Schlüssel zur Absicherung von Wiederholungsversuchen, bis zu 255 Zeichen. Die erneute Verwendung desselben Schlüssels mit demselben Request-Body gibt die ursprüngliche Antwort zurück, ohne ein zweites Screening durchzuführen oder abzurechnen. Die erneute Verwendung des Schlüssels mit einem anderen Body gibt 409 zurück.
255Body
Vollständiger Name der zu überprüfenden Person oder des zu überprüfenden Unternehmens. Mindestens 2 Zeichen – die Mindestanforderung des Screening-Anbieters. Ein kürzerer oder leerer Name führt bei diesem Feld zu einem 400-Fehler, bevor ein Screening durchgeführt wird, sodass keine Kosten anfallen.
2"Antonio Ejemplo Modelo"
Art der zu screenenden Entität. Standardwert ist person.
person, company Geburtsdatum (Personen) oder Gründungsdatum (Unternehmen), YYYY-MM-DD. Verbessert die Übereinstimmungsgenauigkeit über die Gewichtung des Geburtsdatums.
"1972-02-29"
ISO 3166-1-Alpha-2-Ländercode (z. B. ES). Ungültige Codes geben 400 zurück. Verbessert die Genauigkeit der Übereinstimmung über die Ländergewichtung.
"ES"
Ausweisnummer. Nicht gewichtet – fungiert als eindeutiger Schlüssel: Eine exakte Übereinstimmung überschreibt den match_score des Treffers auf 100, eine harte Nichtübereinstimmung straft ihn ab. Wird nur dann als Suchfilter an den Screening-Anbieter gesendet, wenn sie 2-50 Zeichen lang ist; ein Wert außerhalb dieses Bereichs wird akzeptiert und gespeichert, und das Screening wird weiterhin ausgeführt und abgerechnet, jedoch nicht nach Ausweisnummer eingegrenzt.
Risiko-Score-Schwellenwert, bei oder unter dem das Ergebnis Approved ist. Muss ≤ aml_score_review_threshold sein (andernfalls 400).
0 <= x <= 100Risiko-Score-Schwellenwert, über dem das Ergebnis Declined ist. Scores zwischen den beiden Schwellenwerten führen zu In Review.
0 <= x <= 100Gewichtung der Namensähnlichkeit im Übereinstimmungswert pro Treffer. Die drei Gewichtungen müssen in der Summe genau 100 ergeben (andernfalls 400).
0 <= x <= 100Gewichtung des Geburtsdatums im Übereinstimmungswert pro Treffer.
0 <= x <= 100Gewichtung von Land/Staatsangehörigkeit im Übereinstimmungswert pro Treffer.
0 <= x <= 100Schwellenwert pro Treffer: Treffer mit einem match_score darunter gelten als False Positive (von der Risikobewertung ausgeschlossen); bei oder darüber gelten sie als mögliche Unreviewed-Treffer.
0 <= x <= 100Auch Nachrichtenmedien nach negativen Berichten durchsuchen. Erhöht die Latenz um bis zu ~30 s, während Ergebnisse gesammelt werden – verwenden Sie ein Client-Timeout von ≥60 s.
Dieses Profil kontinuierlich erneut screenen und Änderungen per Webhook übertragen. Erfordert save_api_request=true (andernfalls 400).
Das Screening als Sitzung beibehalten (Sichtbarkeit in der Konsole, Entscheidungs-Endpoint, Webhooks, Trefferprüfung). Für eine zustandslose Prüfung auf false setzen.
Ihre Kennung für den geprüften Benutzer; wird zurückgegeben und mit der Sitzung gespeichert.
Freiform-JSON, das mit der Anfrage gespeichert und zurückgegeben wird.
Nur für die Sandbox gültiger Szenario-Slug. Wird nur akzeptiert, wenn der API-Schlüssel zu einer Anwendung im Sandbox-Modus gehört; bei Live-Anwendungen abgelehnt. Ein eigenständiges Screening verfügt über keine Sitzung, die vorbereitet werden könnte, daher wird der Slug direkt in der Screening-Anfrage angegeben: decline_aml_hit gibt einen Treffer in Produktionsform zurück und schließt das Screening mit Declined ab, review_aml_possible_match schließt es mit In Review ab, und ein Szenario, das kein AML-Ergebnis vorbereitet, lässt das Screening ohne Treffer. Den Szenarienkatalog finden Sie unter GET /v1/sandbox/scenarios/ oder Sandbox & Test Data.
"decline_aml_hit"
Antwort
Screening abgeschlossen. aml.status spiegelt Ihre Schwellenwerte wider; jeder Treffer, der den internen Mindestwert erreicht oder überschreitet, wird in aml.hits mit seinem Identitäts-match_score, Entitäts-risk_score und einer score_breakdown zur Erklärung der Übereinstimmung aufgeführt.
Beibehaltene Sitzungs-ID, wenn save_api_request=true (verwendbar mit GET /v3/session/{sessionId}/decision/); andernfalls eine vorübergehende Korrelations-UUID.
Show child attributes
Show child attributes
Wiedergabe der von Ihnen gesendeten vendor_data.
Rückgabe der von Ihnen gesendeten metadata.