Vérification des données

MarkdownChatGPTClaude

Point de terminaison

Environnement	URL
Production	POST https://api.idcloud.unico.app/lists/{cpf}
Sandbox	POST https://api.idcloud.uat.unico.app/lists/{cpf}

Point de terminaison distinct, par conception

Ce point de terminaison est distinct de la création de processus standard (POST /processes/v1). Il fournit une liste de données — et non un résultat déterministe de vérification d'identité.

Requête

En-têtes

En-tête	Valeur
Authorization	Bearer <access_token> (voir Authentification)

Paramètres de chemin

Paramètre	Type	Obligatoire	Description
cpf	string	oui	CPF de la personne à interroger.

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

Réponse

Enveloppe racine

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

Champ	Type	Description
id	string (UUID)	Identifiant unique de la requête.
status	integer	Statut du traitement.
lists	object	Charge utile principale contenant les données demandées.

---

`lists.basicData` — Données d'enregistrement

{
  "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",
    "socialName": ""
  }
}

Champ	Type	Description
name	string	Nom complet.
birthCountry	string	Pays de naissance.
birthDate	string (ISO 8601)	Date de naissance.
gender	string	Genre.
motherName	string	Nom de la mère.
fatherName	string	Nom du père.
maritalStatus	string	État civil.
rgNumber	string	Numéro du RG.
rgIssuingAgency	string	Organisme émetteur du RG.
rgStateCode	string	Code de l'État du RG.
financialData.​incomeEstimate	string	Estimation des revenus.
financialData.​totalAssets	string	Total des actifs.
email	string	E-mail.
phone	string	Téléphone.
socialName	string	Nom social. Peut être vide si la personne n'a pas de nom social enregistré.

basicData.address:

Champ	Type	Description
addressMain	string	Nom de la rue.
number	string	Numéro.
complement	string	Complément.
neighborhood	string	Quartier.
zipCode	string	Code postal.
city	string	Ville.
state	string	Code de l'État.
country	string	Pays.
type	string	Type d'adresse (ex. WORK).

---

`lists.riskData.taxIdValidation` — Validation du CPF

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

Champ	Type	Description
taxIdStatus	string	Statut d'enregistrement du CPF.
taxIdStatusDate	string	Date du statut d'enregistrement.
decease	boolean	Indique un décès.
under18	boolean	Indique une personne mineure (moins de 18 ans).

---

`lists.riskData.pep` — Personne politiquement exposée

{
  "pep": {
    "isCurrentlyPep": true,
    "records": [
      {
        "level": "1",
        "jobTitle": "SENADOR",
        "motive": "FEDERAL EMPLOYEE"
      }
    ]
  }
}

Champ	Type	Description
isCurrentlyPep	boolean	Est actuellement une PPE.
records	array	Antécédents PPE propres à la personne.
records[].level	string	Niveau d'exposition politique.
records[].jobTitle	string	Fonction occupée.
records[].motive	string	Motif de classification.

---

`lists.riskData.aml` — Lutte contre le blanchiment d'argent (Sanctions)

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

Champ	Type	Description
isSanctioned	boolean	Fait l'objet d'une sanction.
records	array	Sanctions propres à la personne.
records[].type	string	Type de sanction.
records[].source	string	Source de la sanction.
records[].​standardizedType	string	Type normalisé.
records[].endDate	string	Date de fin.

---

`lists.riskData.sportsRelationship` — Relation avec les paris sportifs

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

Champ	Type	Description
hasSportsRelationship	boolean	A une relation avec le sport.
isCurrentlyAthlete	boolean	Est un athlète en activité.
isCurrentlySportsCoach	boolean	Est un entraîneur en activité.
isCurrentlySportsClubDirector	boolean	Est un dirigeant de club en activité.
isCurrentlyReferee	boolean	Est un arbitre en activité.
isCurrentlyRelatedToFinanceMinistry	boolean	A une relation avec le ministère des Finances.
isCurrentlyBettingCompanyOwner	boolean	Est propriétaire d'une société de paris.
sportsRelationshipMotive	string	Motif de la relation.
sportExposures	array	Expositions sportives détaillées.

sportExposures[]:

Champ	Type	Description
sportName	string	Nom du sport.
region	string	Région d'activité.
totalRelatedEntities	integer	Total des entités liées.
relationshipLevel	string	Niveau de relation.
endDate	string	Date de fin.

---

Codes d'erreur

400 Bad Request

Code	Message	Description
99989	The document is invalid.	Lorsque le CPF est invalide.

403 Forbidden

Code	Message	Description
10501	The authorization token is invalid.	Le jeton d'authentification est invalide.

500 Internal Server Error

Code	Message	Description
99999	Internal failure! Try again later	Lorsqu'il y a une erreur interne.