Dados cadastrais CPF

Nome, data de nascimento, filiação e situação cadastral de uma pessoa pelo CPF.

Entrada: CPFAssíncrona (requestId)

Gerar chave de API Ver preços

Quando usar

Onboarding

Valide o cadastro de clientes e fornecedores pessoa física.

Prevenção a fraude

Confira se nome e CPF batem antes de liberar crédito ou acesso.

Como funciona

Fluxo assíncrono

Seu sistemaAPI

1POSTCriar consulta
Envia o documento e recebe o requestId na hora.
2GETAcompanhar
Repete a chamada com o requestId enquanto o status for pending.
3GETBuscar resultado
Com status done, o resultado completo vem em data.

Como acompanhar o resultado

Repita o GET a cada 2 ou 3 segundos até o status ser done ou error. A maioria das consultas termina em poucos segundos.

Passo 1

Criar consulta

POST/api/partner/v2/people/basic-data

Criar consulta de dados básicos (CPF).

Corpo da requisição

documentstringobrigatório
CPF com 11 dígitos (apenas números)

Respostas

200Solicitação criada com sucesso
400Documento inválido
401Não autorizado
402Saldo insuficiente

Requisição

curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/people/basic-data" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"document":"12345678901"}'

Resposta · 200

{
  "requestId": "cm8p1q2r30004ab12cdef5678",
  "message": "Solicitação realizada com sucesso"
}

Passo 2

Buscar resultado

GET/api/partner/v2/people/basic-data/{requestId}

Consultar resultado de dados básicos (CPF).

Parâmetros do caminho

requestIdstringno caminhoobrigatório

Respostas

200Resultado da solicitação

Requisição

curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/people/basic-data/cm8p1q2r30004ab12cdef5678" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Resposta · 200

{
  "data": {
    "document": "12345678901",
    "country": "BRAZIL",
    "name": "MARIA OLIVEIRA COSTA",
    "alternativeIdNumbers": {
      "RG - SP": "123456789",
      "SocialSecurityNumber": "12345678901"
    },
    "aliases": {
      "id": 1024,
      "commonName": "MARIA COSTA",
      "standardizedName": "MARIA OLIVEIRA COSTA",
      "basicDataId": 2048
    },
    "gender": "F",
    "nameWordCount": 3,
    "numberOfFullNameNamesakes": 12,
    "nameUniquenessScore": 0.083,
    "firstNameUniquenessScore": 0.0001,
    "firstAndLastNameUniquenessScore": 0.0005,
    "birthDate": "1985-04-12T00:00:00.000Z",
    "age": 41,
    "zodiacSign": "ARIES",
    "chineseSign": "Ox",
    "birthCountry": "BRASILEIRA",
    "motherName": "ANA OLIVEIRA COSTA",
    "fatherName": "JOSE PEREIRA COSTA",
    "maritalStatusData": {
      "MaritalStatus": "CASADO(A)",
      "MaritalStatusLastUpdateDate": "2021-06-10T00:00:00Z"
    },
    "status": "REGULAR",
    "origin": "RECEITA FEDERAL",
    "fiscalRegion": "SP",
    "hasObitIndication": false,
    "statusDate": "2024-09-05T00:00:00.000Z",
    "statusRegistrationDate": "2003-03-05T00:00:00.000Z",
    "creationDate": "2016-08-23T00:00:00.000Z",
    "lastUpdateDate": "2024-09-05T00:00:00.000Z"
  },
  "status": "done"
}

O que a resposta traz

Dados pessoais

Nome completo
name
Nome comum e nome padronizado
aliases
Variações do nome usadas em cadastros.
Data de nascimento e idade
birthDate · age
Gênero
gender
M, F ou U (não informado).
Estado civil
maritalStatusData
Estado civil e data da última atualização, quando disponível.
Nacionalidade
birthCountry
Signo e signo chinês
zodiacSign · chineseSign

Filiação

Nome da mãe e do pai
motherName · fatherName

Situação do CPF

Situação cadastral
status
Ex.: REGULAR, PENDENTE DE REGULARIZACAO, SUSPENSA, CANCELADA, TITULAR FALECIDO.
Data da situação e data de inscrição
statusDate · statusRegistrationDate
Origem e região fiscal
origin · fiscalRegion
Região fiscal da Receita, ex.: SP, ES-RJ, PR-SC.
Indicação de óbito
hasObitIndication
Outros documentos
alternativeIdNumbers
RG por UF, NIS e título de eleitor, quando encontrados.
Criação e atualização do cadastro
creationDate · lastUpdateDate

Análise do nome

Palavras no nome
nameWordCount
Homônimos com o nome completo
numberOfFullNameNamesakes
Unicidade do nome
nameUniquenessScore · firstNameUniquenessScore · firstAndLastNameUniquenessScore
De 0 a 1 para o nome completo, o primeiro nome e o primeiro com o último. Quanto maior, mais raro.

Valores por plano

Plano mensal	Valor da consulta
Sob demanda	R$ 2,50
R$ 100/mês até 166 consultas	R$ 0,60
R$ 300/mês até 666 consultas	R$ 0,45
R$ 500/mês até 1.190 consultas	R$ 0,42
R$ 1.000/mês até 2.631 consultas	R$ 0,38
R$ 3.000/mês até 9.375 consultas	R$ 0,32
R$ 10.000/mês até 35.714 consultas	R$ 0,28
R$ 20.000/mês até 133.333 consultas	R$ 0,15

O valor é cobrado por consulta, na criação da consulta. Ler o resultado de novo pelo mesmo requestId não gera nova cobrança.

Sem plano, a conta usa o valor Sob demanda e paga só o que consumir.

Comparar planos

Próximos passos

Autenticação

Gere a chave e envie no cabeçalho.

Erros e códigos

Como tratar cada resposta de erro.

Cobrança e reembolso

Quando cobramos e quando o valor volta.

Dados cadastrais CNPJ

Razão social, situação cadastral, CNAE, natureza jurídica e capital social de uma empresa pelo CNPJ.

Telefones

Telefones vinculados a um CPF, com tipo, operadora e indicação de qual é o principal.

E-mails

E-mails vinculados a um CPF, com tipo (pessoal ou profissional), status de validação e prioridade.