Zum Hauptinhalt springen
POST
Gibt den CPF-Status (regulär, gesperrt, annulliert), den Namen, den sozialen Namen und das Registrierungsdatum von der Receita Federal über SERPRO zurück. Die Abfrage erfolgt anhand der CPF und des Geburtsdatums. Didit stellt diesen Dienst über POST /v3/database-validation/ bereit, sodass Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Übereinstimmungsergebnisse erhalten können. Eingabeformat: tax_number nimmt die brasilianische CPF entgegen (genau 11 Ziffern).

Abdeckung

  • Abdeckung: ~ 100%
  • Land: Brasilien
  • Service-ID: bra_cpf
  • Datenbereich: Identität
  • Kategorie: TaxRegistry

Eingaben

  • Pflichteingaben: tax_number, date_of_birth
  • Optionale Eingaben: first_name, last_name, vendor_data
  • Einwilligung: Nicht erforderlich
  • Verfügbarkeit im Workflow: Im Workflow verfügbar
  • Abdeckung: ~ 100%
  • Preis: $0.20 pro erfolgreicher Abfrage
Nicht jedes Dokument, das dieser Dienst akzeptiert, enthält die Kennung, über die abgefragt wird. Wird die Kennung nicht aus dem Dokument extrahiert, wird die Prüfung als nicht anwendbar erfasst: Es wird keine Datenbank abgefragt, und Ihnen wird nichts berechnet. In manchen Ländern betrifft das einen erheblichen Anteil der tatsächlichen Nutzer. Um diese Fälle abzudecken, erfassen Sie die Kennung zusätzlich aus einer Antwort im Fragebogen, einem Feld der Document-AI-Extraktion oder einem Wert, den Sie beim Erstellen der Sitzung übermitteln, und ordnen Sie sie im Schritt Datenbankvalidierung zu.

Body-Parameter

string
Standard:"BRA"
erforderlich
ISO-3166-1-Ländercode mit drei Buchstaben (Alpha-3) für diesen Datenbankdienst.Beispiel: BRA
string
Standard:"bra_cpf"
erforderlich
Array mit dieser Dienst-ID. Die Festlegung des Dienstes beschränkt die Anfrage auf genau diese Datenbank.Beispiel: bra_cpf
string
Standard:"11111111111"
erforderlich
Steuernummer.Beispiel: 11111111111
string
Standard:"1990-01-01"
erforderlich
Geburtsdatum im Format YYYY-MM-DD.Beispiel: 1990-01-01
string
Zu validierender Vorname.Beispiel: John
string
Zu validierender Nachname.Beispiel: Doe
string
Standard:"user-1234"
Ihre stabile Benutzerreferenz für diese Person, etwa Ihre interne Benutzer-ID. Didit verwendet sie, um eigenständige Prüfungen demselben Endbenutzer zuzuordnen und unnötige Treffer bei der Duplikaterkennung zu reduzieren.Beispiel: user-1234

Eingaberegeln und Validierungshinweise

  • Brasilianische CPF (genau 11 Ziffern)
  • tax_number darf nur Ziffern enthalten. Entfernen Sie Leerzeichen, Bindestriche und Satzzeichen, bevor Sie die Anfrage senden.
  • tax_number muss genau 11 Zeichen lang sein.

So rufen Sie den Dienst auf

Rückgabedaten

Welche Felder genau in source_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für bra_cpf dokumentiert derzeit diese normalisierte Struktur:
  • date_of_birth
  • first_name
  • identification_number
  • last_name
  • lgpd_minor
  • minor_under_16
  • minor_under_18
  • registration_date

Preise und SLAs

Brasilien - Statusabfragen zur CPF werden nur berechnet, wenn Didit von der Validierungsquelle ein schlüssiges Ergebnis erhält.
  • Preis pro Aufruf: $0.20 USD.
  • Abrechnung: pro erfolgreicher Abfrage. Ihnen wird nichts berechnet, wenn das Register nicht erreichbar ist, wenn Pflichtfelder fehlen oder wenn die Anfrage abgelehnt wird, bevor sie die Quelle erreicht.
  • Latenz: typischer p95-Wert < 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