Verificación de Datos

Endpoint

Entorno	URL
Producción	`POST https://api.id.unico.app/lists/{cpf}`
Sandbox	`POST https://api.id.uat.unico.app/lists/{cpf}`

Endpoint separado por diseño

Este endpoint es independiente de la creación estándar de procesos (POST /processes/v1). Devuelve una lista de datos, no un resultado determinista de verificación de identidad.

Solicitud

Headers

Header	Valor
`Authorization`	`Bearer <access_token>` (ver Autenticación)

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción
`cpf`	string	sí	CPF de la persona a consultar.

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

Respuesta

Envelope raíz

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

Campo	Tipo	Descripción
`id`	string (UUID)	Identificador único de la solicitud.
`status`	integer	Estado del procesamiento.
`lists`	object	Payload principal con los datos consultados.

`lists.basicData` — Datos de registro

{
  "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	Descripción
`name`	string	Nombre completo.
`birthCountry`	string	País de nacimiento.
`birthDate`	string (ISO 8601)	Fecha de nacimiento.
`gender`	string	Género.
`motherName`	string	Nombre de la madre.
`fatherName`	string	Nombre del padre.
`maritalStatus`	string	Estado civil.
`rgNumber`	string	Número de RG.
`rgIssuingAgency`	string	Organismo emisor del RG.
`rgStateCode`	string	Código de estado del RG.
`financialData.incomeEstimate`	string	Estimación de ingresos.
`financialData.totalAssets`	string	Total de activos.
`email`	string	Correo electrónico.
`phone`	string	Teléfono.

basicData.address:

Campo	Tipo	Descripción
`addressMain`	string	Nombre de la calle.
`number`	string	Número.
`complement`	string	Complemento.
`neighborhood`	string	Barrio.
`zipCode`	string	Código postal.
`city`	string	Ciudad.
`state`	string	Código de estado.
`country`	string	País.
`type`	string	Tipo de dirección (ej.: `WORK`).

`lists.riskData.taxIdValidation` — Validación de CPF

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

Campo	Tipo	Descripción
`taxIdStatus`	string	Estado de registro del CPF.
`taxIdStatusDate`	string	Fecha del estado de registro.
`decease`	boolean	Indica fallecimiento.
`under18`	boolean	Indica menor de 18 años.

`lists.riskData.pep` — Persona Políticamente Expuesta

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

Campo	Tipo	Descripción
`isCurrentlyPep`	boolean	Es actualmente una PEP.
`records`	array	Registros PEP propios.
`records[].level`	string	Nivel de exposición política.
`records[].jobTitle`	string	Cargo.
`records[].motive`	string	Motivo de clasificación.
`hasRelatedPep`	boolean	Tiene personas relacionadas con PEP.
`related`	array	Lista de personas relacionadas con PEP.
`related[].taxId`	string	CPF de la persona relacionada.
`related[].level`	string	Nivel de exposición.
`related[].jobTitle`	string	Cargo de la persona relacionada.

`lists.riskData.aml` — Antilavado de Dinero (Sanciones)

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

Campo	Tipo	Descripción
`isSanctioned`	boolean	Está sancionado.
`records`	array	Sanciones propias.
`records[].type`	string	Tipo de sanción.
`records[].source`	string	Fuente de la sanción.
`records[].standardizedType`	string	Tipo estandarizado.
`records[].endDate`	string	Fecha de fin.
`hasRelatedSanctioned`	boolean	Tiene personas relacionadas sancionadas.
`relatedRecords`	array	Sanciones de personas relacionadas.

`lists.riskData.sportsRelationship` — Relación con apuestas deportivas

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

Campo	Tipo	Descripción
`hasSportsRelationship`	boolean	Tiene relación con el deporte.
`isCurrentlyAthlete`	boolean	Es atleta activo.
`isCurrentlySportsCoach`	boolean	Es entrenador activo.
`isCurrentlySportsClubDirector`	boolean	Es director de club activo.
`isCurrentlyReferee`	boolean	Es árbitro activo.
`isCurrentlyRelatedToFinanceMinistry`	boolean	Tiene relación con el Ministerio de Finanzas.
`isCurrentlyBettingCompanyOwner`	boolean	Es propietario de una empresa de apuestas.
`sportsRelationshipMotive`	string	Motivo de la relación.
`sportExposures`	array	Exposiciones deportivas detalladas.

sportExposures[]:

Campo	Tipo	Descripción
`sportName`	string	Nombre del deporte.
`region`	string	Región de actividad.
`totalRelatedEntities`	integer	Total de entidades relacionadas.
`relationshipLevel`	string	Nivel de relación.
`endDate`	string	Fecha de fin.

Códigos de Error

400 Bad Request
403 Forbidden
500 Internal Server Error

Código	Mensaje	Descripción
`99989`	The document is invalid.	Cuando el CPF es inválido.

Código	Mensaje	Descripción
`10501`	The authorization token is invalid.	El token de autenticación es inválido.

Código	Mensaje	Descripción
`99999`	Internal failure! Try again later	Cuando ocurre un error interno.

Endpoint​

Solicitud​

Respuesta​

Códigos de Error​

Endpoint

Solicitud

Respuesta

Códigos de Error