curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
🇧🇷 Brasilien
Brasilien – Gesellschafter und Geschäftsführer (QSA) API
Brasilien-Datenbankabfrage für Gesellschafter und Geschäftsführer (QSA) über Didit. Pay-per-call ab $0.20, keine Verträge, keine Mindestabnahme.
POST
/
v3
/
database-validation
/
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
Gibt die aktuellen Gesellschafter und Geschäftsführer (QSA) eines brasilianischen Unternehmens aus dem Register der Receita Federal zurück, jeweils mit Rolle und Startdatum. CPFs natürlicher Personen werden so maskiert, wie die Receita Federal sie veröffentlicht. Didit stellt diesen Dienst über
POST /v3/database-validation/ bereit, damit Sie die übermittelten Daten mit der maßgeblichen Quelle abgleichen und normalisierte Abgleichsergebnisse erhalten.
Abdeckung
- Abdeckung: ~ 100%
- Land: Brasilien
- Dienst-ID:
bra_company_directors - Datenbereich: Regierung
- Kategorie: CompanyRegister
Eingaben
| Feld | Pflichtfeld | Beispiel |
|---|---|---|
company_registration_number | Ja | 11222333000181 |
vendor_data | Nein | user-1234 |
- Pflichteingaben:
company_registration_number - Optionale Eingaben:
vendor_data - Einwilligung: Nicht erforderlich
- Verfügbarkeit im Workflow: Im Workflow mit Feldzuordnung verfügbar
- Abdeckung: ~ 100%
- Preis: $0.20 pro erfolgreicher Abfrage
company_registration_number nicht auf einem Ausweisdokument, daher erzeugt kein Schritt diesen Wert von selbst. Erfassen Sie ihn über eine Fragebogen-Antwort, ein Extraktionsfeld von Document AI oder einen Wert, den Sie beim Erstellen der Sitzung senden, und ordnen Sie ihn im Schritt Datenbankvalidierung zu. Solange die Zuordnung fehlt, zeigt der Workflow-Editor diesen Dienst als deaktiviert an und benennt die fehlende Eingabe. Zur Laufzeit bedeutet eine fehlende Eingabe, dass die Prüfung vor jeder Abfrage übersprungen wird. Ihnen wird also nie eine Abfrage für eine Datenbank berechnet, die nicht abgefragt werden konnte.
Body-Parameter
string
Standard:"BRA"
erforderlich
ISO-3166-1-Alpha-3-Ländercode für diesen Datenbankdienst.Beispiel:
BRAstring
Standard:"bra_company_directors"
erforderlich
Array mit der ID dieses Dienstes. Durch das Festlegen des Dienstes bleibt die Anfrage auf genau diese Datenbank beschränkt.Beispiel:
bra_company_directorsstring
Standard:"11222333000181"
erforderlich
Für diesen Datenbankdienst erforderlicher Wert
company_registration_number.Beispiel: 11222333000181string
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 Störungen durch die Duplikaterkennung zu reduzieren.Beispiel:
user-1234Eingaberegeln und Validierungshinweise
company_registration_numbermuss dem Muster[0-9A-Za-z]{2}\.?[0-9A-Za-z]{3}\.?[0-9A-Za-z]{3}/?[0-9A-Za-z]{4}-?\d{2}entsprechen.
So rufen Sie den Dienst auf
curl -X POST "https://verification.didit.me/v3/database-validation/" \
-H "x-api-key: YOUR_API_KEY" \
-F "issuing_state=BRA" \
-F "services=bra_company_directors" \
-F "vendor_data=user-1234" \
-F "company_registration_number=11222333000181"
Jede erfolgreiche Anfrage liefert HTTP
200 zurück. Das Feld outcome_code zeigt, was tatsächlich passiert ist, etwa ob ein echter biometrischer Abgleich fehlgeschlagen ist (BIOMETRIC_NO_MATCH) oder ob ein Selfie nicht gelesen werden konnte (BIOMETRIC_IMAGE_UNUSABLE). Der angezeigte status ist der Standardstatus der Funktion. Ihre konfigurierten Aktionen für Partial Match / No Match können ihn überschreiben.MATCH: Das Register hat die Identität bestätigt, und jedes geprüfte Feld stimmte überein.{
"request_id": "req_01H…",
"status": "Approved",
"issuing_state": "BRA",
"match_type": "full_match",
"validations": [
{
"outcome_code": "MATCH",
"service_id": "bra_company_directors",
"service_name": "Brazil - Company Partners and Directors (QSA)",
"source_data": {
"directors": [
{
"document_number": "***.456.789-**",
"entity_type": "person",
"name": "MARIA EXEMPLO DA SILVA",
"role": "SOCIO-ADMINISTRADOR",
"start_date": "2010-03-15"
},
{
"document_number": "11444777000161",
"entity_type": "company",
"name": "HOLDING EXEMPLO S A",
"role": "SOCIO",
"start_date": "2018-06-01"
}
],
"registration_number": "11222333000181"
},
"validation": {}
}
]
}
Rückgabedaten
Welche Felder genau insource_data erscheinen, hängt davon ab, was das Register zurückgibt. Das generierte Beispiel für bra_company_directors dokumentiert derzeit diese normalisierte Struktur:
directorsregistration_number
Preise und SLAs
Abfragen zu Gesellschaftern und Geschäftsführern (QSA) in Brasilien werden nur berechnet, wenn Didit von der Validierungsquelle ein eindeutiges 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: typischerweise p95 unter 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