Zum Hauptinhalt springen
POST
Prüft Eingabedaten gegen Credit-Header-Daten, die von einer Kreditauskunftei in Deutschland bezogen wurden. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Trefferergebnisse erhalten.

Abdeckung

  • Abdeckung: ~ 80%
  • Land: Deutschland
  • Dienst-ID: deu_credit_bureau
  • Datenbereich: Finanzen
  • Kategorie: CreditBureau

Eingaben

  • Pflichteingaben: first_name, last_name, date_of_birth, address.street_1, address.postal_code
  • Optionale Eingaben: address.street_2, address.city, address.region, vendor_data
  • Einwilligung: Erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 80%
  • Preis: $1.40 pro erfolgreiche Abfrage

Body-Parameter

string
Standard:"DEU"
erforderlich
ISO 3166-1 Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel: DEU
string
Standard:"deu_credit_bureau"
erforderlich
Array mit der ID dieses Dienstes. Durch das Festlegen des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel: deu_credit_bureau
Ausdrückliche Einwilligung des Endbenutzers für diesen Dienst.Beispiel: true
string
Standard:"John"
erforderlich
Zu prüfender Vorname.Beispiel: John
string
Standard:"Doe"
erforderlich
Zu prüfender Nachname.Beispiel: Doe
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
object
erforderlich
Strukturiertes Adressobjekt für den Wohnsitz. Verwenden Sie street_1, street_2, city, region, postal_code und country. Ein vollständiger Adressstring im alten Format wird weiterhin akzeptiert, ist aber nicht empfohlen.Beispiel: {"street_1":"123 Sample Street","street_2":"Unit 4","city":"Sample City","region":"Sample State","postal_code":"10001","country":"US"}
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, zum Beispiel Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen mit demselben Endbenutzer zu verknüpfen und unnötige Duplikatmeldungen zu verringern.Beispiel: user-1234

Eingaberegeln & Validierungshinweise

  • Senden Sie bei Adressdiensten nach Möglichkeit strukturierte Adressfelder statt eines einzelnen address-Strings.
  • address.street_1 ist die Straßenadresse einschließlich Hausnummer und Straßenart.
  • address.street_2 ist eine Wohnung, Einheit, ein Gebäude, eine Etage oder eine zusätzliche Adresszeile. Senden Sie sie nur, wenn Sie sie haben.
  • address.city bezeichnet eine Stadt, einen Stadtteil, einen Bezirk, eine Ortschaft oder ein Viertel.
  • address.region bezeichnet ein Bundesland, eine Provinz, eine Region oder einen Ort.
  • address.postal_code ist die Postleitzahl.
  • Adressbasierte Datenbankdienste erfordern mindestens Straßenadresse und Postleitzahl. Anfragen, die vor der Quellenabfrage abgelehnt werden, werden nicht berechnet.

So rufen Sie es auf

Zurückgegebene Daten

Welche Felder genau in source_data ausgegeben werden, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für deu_credit_bureau dokumentiert derzeit folgende normalisierte Struktur:
  • address
  • address_match_score
  • city
  • date_of_birth
  • first_name
  • full_name
  • last_name
  • name_match_score
  • postal_code
  • street

Preise & SLAs

Abfragen beim Credit Bureau Deutschland werden nur dann abgerechnet, wenn Didit von der Validierungsquelle ein eindeutiges Ergebnis erhält.
  • Preis pro Aufruf: $1.40 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Ihnen werden keine Gebühren berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischerweise p95 < 2 s.
  • Verfügbarkeit: 99.9% pro Quartal auf Seiten von Didit; die Verfügbarkeit der nachgelagerten Quelle variiert je nach Land und Datensatz.

Weiterlesen

Zuletzt geändert am 7. November 2026