Verificação de Dados

Endpoint

Ambiente	URL
Produção	POST https://api.id.unico.app/lists/{cpf}
Sandbox	POST https://api.id.uat.unico.app/lists/{cpf}

Endpoint separado por design

Este endpoint é separado da criação de processo padrão (POST /processes/v1). Ele retorna uma lista de dados — não um resultado determinístico de verificação de identidade.

Requisição

Headers

Header	Valor
Authorization	Bearer <access_token> (consulte Autenticação)

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
cpf	string	sim	CPF da pessoa a ser consultada.

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

Resposta

Envelope raiz

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

Campo	Tipo	Descrição
id	string (UUID)	Identificador único da requisição.
status	integer	Status do processamento.
lists	object	Payload principal com os dados consultados.

---

`lists.basicData` — Dados cadastrais

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

Campo	Tipo	Descrição
name	string	Nome completo.
birthCountry	string	País de nascimento.
birthDate	string (ISO 8601)	Data de nascimento.
gender	string	Gênero.
motherName	string	Nome da mãe.
fatherName	string	Nome do pai.
maritalStatus	string	Estado civil.
rgNumber	string	Número do RG.
rgIssuingAgency	string	Órgão emissor do RG.
rgStateCode	string	Código de estado do RG.
financialData.incomeEstimate	string	Estimativa de renda.
financialData.totalAssets	string	Total de ativos.
email	string	E-mail.
phone	string	Telefone.

basicData.address:

Campo	Tipo	Descrição
addressMain	string	Nome da rua.
number	string	Número.
complement	string	Complemento.
neighborhood	string	Bairro.
zipCode	string	CEP.
city	string	Cidade.
state	string	Código do estado.
country	string	País.
type	string	Tipo de endereço (ex.: WORK).

---

`lists.riskData.taxIdValidation` — Validação de CPF

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

Campo	Tipo	Descrição
taxIdStatus	string	Situação cadastral do CPF.
taxIdStatusDate	string	Data da situação cadastral.
decease	boolean	Indica óbito.
under18	boolean	Indica menor de 18 anos.

---

`lists.riskData.pep` — Pessoa Politicamente Exposta

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

Campo	Tipo	Descrição
isCurrentlyPep	boolean	É atualmente uma PEP.
records	array	Registros PEP próprios.
records[].level	string	Nível de exposição política.
records[].jobTitle	string	Cargo.
records[].motive	string	Motivo da classificação.
hasRelatedPep	boolean	Possui relacionados PEP.
related	array	Lista de relacionados PEP.
related[].taxId	string	CPF do relacionado.
related[].level	string	Nível de exposição.
related[].jobTitle	string	Cargo do relacionado.

---

`lists.riskData.aml` — Prevenção à Lavagem de Dinheiro (Sanções)

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

Campo	Tipo	Descrição
isSanctioned	boolean	Está sancionado.
records	array	Sanções próprias.
records[].type	string	Tipo de sanção.
records[].source	string	Fonte da sanção.
records[].standardizedType	string	Tipo padronizado.
records[].endDate	string	Data de término.
hasRelatedSanctioned	boolean	Possui relacionados sancionados.
relatedRecords	array	Sanções de relacionados.

---

`lists.riskData.sportsRelationship` — Vínculo com apostas esportivas

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

Campo	Tipo	Descrição
hasSportsRelationship	boolean	Possui vínculo esportivo.
isCurrentlyAthlete	boolean	É atleta ativo.
isCurrentlySportsCoach	boolean	É técnico ativo.
isCurrentlySportsClubDirector	boolean	É diretor de clube ativo.
isCurrentlyReferee	boolean	É árbitro ativo.
isCurrentlyRelatedToFinanceMinistry	boolean	Possui vínculo com o Ministério da Fazenda.
isCurrentlyBettingCompanyOwner	boolean	É proprietário de casa de apostas.
sportsRelationshipMotive	string	Motivo do vínculo.
sportExposures	array	Exposições esportivas detalhadas.

sportExposures[]:

Campo	Tipo	Descrição
sportName	string	Nome do esporte.
region	string	Região de atuação.
totalRelatedEntities	integer	Total de entidades relacionadas.
relationshipLevel	string	Nível de relacionamento.
endDate	string	Data de término.

---

Códigos de Erro

400 Bad Request

Código	Mensagem	Descrição
99989	The document is invalid.	Quando o CPF é inválido.

403 Forbidden

Código	Mensagem	Descrição
10501	The authorization token is invalid.	O token de autenticação é inválido.

500 Internal Server Error

Código	Mensagem	Descrição
99999	Internal failure! Try again later	Quando ocorre um erro interno.