Serviços / Pessoas

Cadastro de Pessoa Física

POST/api/v1/cpf/lookup

Dados cadastrais de uma pessoa física a partir do CPF: nome, nome social, data de nascimento, gênero e a situação do CPF na Receita Federal, com data de inscrição e ano de óbito quando houver.

Envie um JSON com cpf, com ou sem pontuação, e, se tiver, birth_date (AAAA-MM-DD): ela é conferida em data_nascimento_confere e amplia a cobertura da consulta. Campo que o cadastro não informa volta null.

CPF sem cadastro na Receita volta com found: false e é cobrado: a consulta foi feita. Sem birth_date, CPF que só pode ser conferido com ela volta 400 (birth_date_required), e CPF com dígito verificador inválido, 422: nenhum dos dois é cobrado.

Fonte dos dados: Cadastro de Pessoas Físicas (CPF) · tempo real

Parâmetros

cpfstringObrigatório

Com ou sem pontuação. O dígito verificador é conferido antes da consulta.

52998224725
body
birth_datestringOpcional

Data de nascimento no formato `AAAA-MM-DD`.

1990-03-15
body

Campos da resposta

Encontrado

found

boolean

CPF

cpf

string

Nome

nome

string

Nome social

nome_social

string

Data de nascimento

data_nascimento

string

Gênero

genero

`M` ou `F`, quando informado.

string

Situação cadastral

situacao_cadastral

Situação do CPF na Receita Federal, quando informada: `REGULAR`, `SUSPENSA`, `PENDENTE DE REGULARIZAÇÃO`, `TITULAR FALECIDO`, `CANCELADA POR MULTIPLICIDADE`, `CANCELADA DE OFÍCIO` ou `NULA`.

string

Data de inscrição

data_inscricao

string

Ano de óbito

ano_obito

integer

Data de nascimento confere

data_nascimento_confere

Se a `birth_date` enviada confere com o cadastro. Nulo quando ela não é enviada.

boolean

Exemplo de resposta

Modelo de resposta: CpfLookupOutput
JSON · response
{  "success": true,  "code": 200,  "code_message": "A requisição foi processada com sucesso.",  "errors": [],  "header": null,  "data_count": 1,  "data": [    {      "found": true,      "cpf": "52998224725",      "nome": "MARIA DA SILVA SANTOS",      "nome_social": null,      "data_nascimento": "1990-03-15",      "genero": "F",      "situacao_cadastral": "REGULAR",      "data_inscricao": "2008-06-10",      "ano_obito": null,      "data_nascimento_confere": true    }  ]}

Casos de uso

Onboarding e KYC

Conferir o nome e a data de nascimento informados contra o CPF antes de abrir a conta, sem pedir documento a mais.

Antifraude em crédito

Barrar CPF suspenso, cancelado ou de titular falecido antes de aprovar crédito, financiamento ou parcelamento.

Preenchimento de cadastro

Completar o nome a partir do CPF digitado, sem o usuário redigitar.

Notas de integração

  • O CPF vai no corpo, nunca na URL: é dado pessoal e não deve ficar em log de acesso.
  • Consulte CPF de terceiros só com finalidade e base legal, como pede a LGPD.