Acessar minha contaAbrir uma conta
GET/api/v2/kyc/background-check/natural-person/{cpf}

Pessoa física

Este endpoint permite a consulta de informações associadas a um CPF, fornecendo detalhes sobre identificação, situação cadastral, antecedentes criminais e processos judiciais.

Parâmetros

Content-TypeObrigatório
header

Tipo de conteúdo da requisição

Tipo:string
cpfObrigatório
path

Número do CPF a ser consultado (somente números)

Tipo:string

Parâmetros da URL

ParâmetroTipoObrigatórioDescrição
cpfstringSimNúmero do CPF a ser consultado (somente números).

Possíveis Erros

CódigoMensagemDescrição
400Invalid CPF formatO CPF informado está em um formato inválido.
401UnauthorizedToken de acesso ausente ou inválido.
404Person not foundNenhuma informação foi encontrada para o CPF informado.
500Internal Server ErrorErro interno no servidor.

Exemplo de Resposta (200 - Sucesso)

  1. Identificação
    • Nome Completo: Nome oficial da pessoa consultada.
    • Sexo: Gênero informado no registro oficial.
    • Idade: Número de anos completos da pessoa.
    • Nome da Mãe: Nome materno conforme registro oficial.
    • Data de Nascimento: Data de nascimento no formato ISO 8601.
  2. Situação Cadastral
    • CPF: Número do CPF consultado.
    • Data de Inscrição no CPF: Data em que o CPF foi registrado.
    • Situação do CPF: Indica se o CPF está regular ou possui alguma restrição.
  3. Endereço
    • Logradouro: Nome da rua/avenida onde a pessoa está registrada.
    • Número: Número do endereço cadastrado.
    • Bairro: Nome do bairro do endereço principal.
    • Município e UF: Cidade e estado de residência.
    • CEP: Código postal do endereço principal.
    • Endereços Anteriores: Lista de estados onde a pessoa já residiu.
  4. Telefones
    • Número de Telefone: Lista de telefones registrados.
    • UF de Cadastro: Estado onde o telefone está registrado.
  5. Antecedentes Criminais
    • Data da Última Consulta: Data da verificação nos registros criminais.
    • Status: Resultado da verificação de antecedentes.
    • Protocolo: Número de referência da consulta realizada.
    • Situação: Indica se há ou não condenações registradas.
  6. Processos Judiciais
    • Total de Processos: Número total de processos judiciais associados à pessoa consultada.
    • Classificação dos Processos: Distribuição por tipo de processo (Criminal, Cível, Trabalhista, Tributário, Eleitoral, Militar).
    • Número de Processos Ativos: Quantidade de processos em andamento onde a pessoa é parte.
    • Número de Processos Passivos: Quantidade de processos onde a pessoa responde como réu.
    • Número de Processos como Parte Ativa: Quantidade de processos onde a pessoa entrou com ação.

Notas

  • Este endpoint é ideal para validação de identidade, análise de risco e conformidade regulatória, garantindo maior segurança nas relações comerciais e financeiras.
curl --location 'https://api-h.nuvende.com.br/api/v2/kyc/background-check/natural-person/52998224725' \
--header 'Authorization: Bearer {{ access_token }}' \
--header 'Content-Type: application/json'

const axios = require("axios");

const config = {
  method: "get",
  url: "https://api-h.nuvende.com.br/api/v2/kyc/background-check/natural-person/52998224725",
  headers: {
    Authorization: "Bearer {{ access_token }}",
    "Content-Type": "application/json",
  },
};

axios(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

import requests

url = "https://api-h.nuvende.com.br/api/v2/kyc/background-check/natural-person/52998224725"

headers = {
    'Authorization': 'Bearer {{ access_token }}',
    'Content-Type': 'application/json'
}

response = requests.get(url, headers=headers)

print(response.text)

<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api-h.nuvende.com.br/api/v2/kyc/background-check/natural-person/52998224725',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer {{ access_token }}',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;
?>

{
  "nome": "João Silva",
  "sexo": "M",
  "idade": 35,
  "nomeMae": "Maria Silva",
  "dataNascimento": "1988-03-15",
  "cpf": "52998224725",
  "dataInscricaoCpf": "2005-08-20",
  "situacaoCpf": "regular",
  "endereco": {
    "logradouro": "Rua das Flores, 123",
    "bairro": "Centro",
    "municipio": "São Paulo",
    "uf": "SP",
    "cep": "01234567"
  },
  "telefones": [
    {
      "numero": "11987654321",
      "ufCadastro": "SP"
    }
  ],
  "antecedentesCriminais": {
    "dataConsulta": "2024-12-26",
    "status": "Nada consta",
    "protocolo": "ABC123456",
    "situacao": "Sem condenações"
  },
  "processosJudiciais": {
    "total": 2,
    "criminal": 0,
    "civel": 1,
    "trabalhista": 1,
    "ativo": 1,
    "passivo": 1
  }
}