Data Verification

MarkdownChatGPTClaude

Endpoint

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

Separate endpoint by design

This endpoint is separate from the standard process creation (POST /processes/v1). It delivers a list of data — not a deterministic identity verification result.

Request

Headers

Header	Value
Authorization	Bearer <access_token> (see Authentication)

Path parameters

Parameter	Type	Required	Description
cpf	string	yes	CPF of the person to query.

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

Response

Root envelope

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

Field	Type	Description
id	string (UUID)	Unique request identifier.
status	integer	Processing status.
lists	object	Main payload with the queried data.

---

`lists.basicData` — Registration data

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

Field	Type	Description
name	string	Full name.
birthCountry	string	Country of birth.
birthDate	string (ISO 8601)	Date of birth.
gender	string	Gender.
motherName	string	Mother's name.
fatherName	string	Father's name.
maritalStatus	string	Marital status.
rgNumber	string	RG number.
rgIssuingAgency	string	RG issuing agency.
rgStateCode	string	RG state code.
financialData.​incomeEstimate	string	Income estimate.
financialData.​totalAssets	string	Total assets.
email	string	Email.
phone	string	Phone.
socialName	string	Social name. May be empty when the person has no registered social name.

basicData.address:

Field	Type	Description
addressMain	string	Street name.
number	string	Number.
complement	string	Complement.
neighborhood	string	Neighborhood.
zipCode	string	ZIP code.
city	string	City.
state	string	State code.
country	string	Country.
type	string	Address type (e.g., WORK).

---

`lists.riskData.taxIdValidation` — CPF validation

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

Field	Type	Description
taxIdStatus	string	CPF registration status.
taxIdStatusDate	string	Date of the registration status.
decease	boolean	Indicates death.
under18	boolean	Indicates under 18 years old.

---

`lists.riskData.pep` — Politically Exposed Person

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

Field	Type	Description
isCurrentlyPep	boolean	Is currently a PEP.
records	array	Own PEP records.
records[].level	string	Level of political exposure.
records[].jobTitle	string	Job title.
records[].motive	string	Classification motive.

---

`lists.riskData.aml` — Anti-Money Laundering (Sanctions)

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

Field	Type	Description
isSanctioned	boolean	Is sanctioned.
records	array	Own sanctions.
records[].type	string	Sanction type.
records[].source	string	Sanction source.
records[].​standardizedType	string	Standardized type.
records[].endDate	string	End date.

---

`lists.riskData.sportsRelationship` — Sports betting relationship

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

Field	Type	Description
hasSportsRelationship	boolean	Has a sports relationship.
isCurrentlyAthlete	boolean	Is an active athlete.
isCurrentlySportsCoach	boolean	Is an active coach.
isCurrentlySportsClubDirector	boolean	Is an active club director.
isCurrentlyReferee	boolean	Is an active referee.
isCurrentlyRelatedToFinanceMinistry	boolean	Has a relationship with the Ministry of Finance.
isCurrentlyBettingCompanyOwner	boolean	Is a betting company owner.
sportsRelationshipMotive	string	Relationship motive.
sportExposures	array	Detailed sport exposures.

sportExposures[]:

Field	Type	Description
sportName	string	Sport name.
region	string	Region of activity.
totalRelatedEntities	integer	Total related entities.
relationshipLevel	string	Relationship level.
endDate	string	End date.

---

Error Codes

400 Bad Request

Code	Message	Description
99989	The document is invalid.	When the CPF is invalid.

403 Forbidden

Code	Message	Description
10501	The authorization token is invalid.	The authentication token is invalid.

500 Internal Server Error

Code	Message	Description
99999	Internal failure! Try again later	When there is an internal error.