Datenverifizierung

Endpunkt

Umgebung	URL
Produktion	POST https://api.id.unico.app/lists/{cpf}
Sandbox	POST https://api.id.uat.unico.app/lists/{cpf}

Separater Endpunkt aus Designgründen

Dieser Endpunkt ist von der Standard-Prozesserstellung (POST /processes/v1) getrennt. Er liefert eine Liste von Daten — kein deterministisches Identitätsverifizierungsergebnis.

Anfrage

Header

Header	Wert
Authorization	Bearer <access_token> (siehe Authentifizierung)

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
cpf	string	ja	CPF der abzufragenden Person.

curl -X POST "https://api.id.uat.unico.app/lists/12345678909" \
  -H "Authorization: Bearer $TOKEN"

Antwort

Stamm-Envelope

{
  "id": "41c24382-36ce-4bb4-8339-352114f71f78",
  "status": 3,
  "lists": { }
}

Feld	Typ	Beschreibung
id	string (UUID)	Eindeutige Anfrage-Kennung.
status	integer	Verarbeitungsstatus.
lists	object	Haupt-Payload mit den abgefragten Daten.

---

`lists.basicData` — Registrierungsdaten

{
  "basicData": {
    "name": "JOAO DA SILVA",
    "birthCountry": "BRASILEIRA",
    "birthDate": "1990-01-01T00:00:00Z",
    "gender": "M",
    "motherName": "MARIA DA SILVA",
    "fatherName": "",
    "maritalStatus": "",
    "rgNumber": "",
    "rgIssuingAgency": "",
    "rgStateCode": "",
    "financialData": {
      "incomeEstimate": "...",
      "totalAssets": "..."
    },
    "address": {
      "addressMain": "AVENIDA DO ESTADO",
      "number": "123",
      "complement": "ANDAR 1",
      "neighborhood": "CENTRO",
      "zipCode": "12345678",
      "city": "SAO PAULO",
      "state": "SP",
      "country": "BRASIL",
      "type": "WORK"
    },
    "email": "...",
    "phone": "+554799999999"
  }
}

Feld	Typ	Beschreibung
name	string	Vollständiger Name.
birthCountry	string	Geburtsland.
birthDate	string (ISO 8601)	Geburtsdatum.
gender	string	Geschlecht.
motherName	string	Name der Mutter.
fatherName	string	Name des Vaters.
maritalStatus	string	Familienstand.
rgNumber	string	RG-Nummer.
rgIssuingAgency	string	Ausstellende Behörde des RG.
rgStateCode	string	Bundesstaatscode des RG.
financialData.incomeEstimate	string	Einkommensschätzung.
financialData.totalAssets	string	Gesamtvermögen.
email	string	E-Mail.
phone	string	Telefon.

basicData.address:

Feld	Typ	Beschreibung
addressMain	string	Straßenname.
number	string	Hausnummer.
complement	string	Adresszusatz.
neighborhood	string	Stadtviertel.
zipCode	string	Postleitzahl.
city	string	Stadt.
state	string	Bundesstaatscode.
country	string	Land.
type	string	Adresstyp (z. B. WORK).

---

`lists.riskData.taxIdValidation` — CPF-Validierung

{
  "taxIdValidation": {
    "taxIdStatus": "REGULAR",
    "taxIdStatusDate": "...",
    "decease": false,
    "under18": false
  }
}

Feld	Typ	Beschreibung
taxIdStatus	string	CPF-Registrierungsstatus.
taxIdStatusDate	string	Datum des Registrierungsstatus.
decease	boolean	Gibt einen Todesfall an.
under18	boolean	Gibt an, ob die Person unter 18 Jahre alt ist.

---

`lists.riskData.pep` — Politisch exponierte Person

{
  "pep": {
    "isCurrentlyPep": true,
    "records": [
      {
        "level": "1",
        "jobTitle": "SENADOR",
        "motive": "FEDERAL EMPLOYEE"
      }
    ],
    "hasRelatedPep": true,
    "related": [
      {
        "taxId": "01253069891",
        "level": "2",
        "jobTitle": "FAMILIAR"
      }
    ]
  }
}

Feld	Typ	Beschreibung
isCurrentlyPep	boolean	Ist derzeit eine PEP.
records	array	Eigene PEP-Einträge.
records[].level	string	Grad der politischen Exposition.
records[].jobTitle	string	Berufsbezeichnung.
records[].motive	string	Klassifizierungsgrund.
hasRelatedPep	boolean	Hat PEP-verwandte Personen.
related	array	Liste PEP-verwandter Personen.
related[].taxId	string	CPF der verwandten Person.
related[].level	string	Expositionsgrad.
related[].jobTitle	string	Berufsbezeichnung der verwandten Person.

---

`lists.riskData.aml` — Geldwäschebekämpfung (Sanktionen)

{
  "aml": {
    "isSanctioned": true,
    "records": [
      {
        "type": "Law Enforcement",
        "source": "interpol",
        "standardizedType": "ARREST WARRANTS",
        "endDate": "..."
      }
    ],
    "hasRelatedSanctioned": false,
    "relatedRecords": []
  }
}

Feld	Typ	Beschreibung
isSanctioned	boolean	Ist sanktioniert.
records	array	Eigene Sanktionen.
records[].type	string	Sanktionstyp.
records[].source	string	Sanktionsquelle.
records[].standardizedType	string	Standardisierter Typ.
records[].endDate	string	Enddatum.
hasRelatedSanctioned	boolean	Hat sanktionierte verwandte Personen.
relatedRecords	array	Sanktionen verwandter Personen.

---

`lists.riskData.sportsRelationship` — Sportwetten-Beziehung

{
  "sportsRelationship": {
    "hasSportsRelationship": false,
    "isCurrentlyAthlete": false,
    "isCurrentlySportsCoach": false,
    "isCurrentlySportsClubDirector": false,
    "isCurrentlyReferee": false,
    "isCurrentlyRelatedToFinanceMinistry": false,
    "isCurrentlyBettingCompanyOwner": false,
    "sportsRelationshipMotive": "",
    "sportExposures": []
  }
}

Feld	Typ	Beschreibung
hasSportsRelationship	boolean	Hat eine Sportbeziehung.
isCurrentlyAthlete	boolean	Ist aktiver Athlet.
isCurrentlySportsCoach	boolean	Ist aktiver Trainer.
isCurrentlySportsClubDirector	boolean	Ist aktiver Vereinsdirektor.
isCurrentlyReferee	boolean	Ist aktiver Schiedsrichter.
isCurrentlyRelatedToFinanceMinistry	boolean	Hat eine Beziehung zum Finanzministerium.
isCurrentlyBettingCompanyOwner	boolean	Ist Eigentümer eines Wettunternehmens.
sportsRelationshipMotive	string	Beziehungsgrund.
sportExposures	array	Detaillierte Sportexpositionen.

sportExposures[]:

Feld	Typ	Beschreibung
sportName	string	Sportbezeichnung.
region	string	Aktivitätsregion.
totalRelatedEntities	integer	Gesamtzahl der verwandten Entitäten.
relationshipLevel	string	Beziehungsgrad.
endDate	string	Enddatum.

---

Fehlercodes

400 Bad Request

Code	Meldung	Beschreibung
99989	The document is invalid.	Wenn die CPF ungültig ist.

403 Forbidden

Code	Meldung	Beschreibung
10501	The authorization token is invalid.	Das Authentifizierungstoken ist ungültig.

500 Internal Server Error

Code	Meldung	Beschreibung
99999	Internal failure! Try again later	Bei einem internen Fehler.