Pessoas
Cadastro de Pessoa Física
AtivaBase cadastralPor requisição● tempo real
POST
/api/v1/cpf/lookupDados 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
Campos da resposta
Dados que esta API devolve em cada chamada.
Na página
Encontrado
foundCPFcpfNomenomeNome socialnome_socialData de nascimentodata_nascimentoGênerogeneroSituação cadastralsituacao_cadastralData de inscriçãodata_inscricaoAno de óbitoano_obitoData de nascimento conferedata_nascimento_confereCasos de uso
Onde esta API entra no seu processo.
Conferir o nome e a data de nascimento informados contra o CPF antes de abrir a conta, sem pedir documento a mais.
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.
Testar e integrar
Execute uma chamada e copie o código para a sua aplicação.
POST
https://api.apifordevs.com/api/v1/cpf/lookupChave de API necessária · application/json · 60 req./min · Cobrança apenas em respostas 2xx
Autenticação
AuthorizationheaderInjetado automaticamenteChave de API em Basic: public_key:secret_key em Base64.
Sessão do painel · ••••••••
X-Project-IdheaderInjetado automaticamenteProjeto que recebe a chamada. Sem ele, vale o projeto padrão da conta.
Projeto selecionado no painel
Idempotency-KeyheaderOpcionalRepetir a mesma chave em até 24 horas devolve a resposta anterior, sem executar nem cobrar de novo.
Parâmetros
stringbodyObrigatório
Com ou sem pontuação. O dígito verificador é conferido antes da consulta.
stringbodyOpcional
Data de nascimento no formato AAAA-MM-DD.
A simulação devolve um exemplo sem chamar o serviço nem cobrar. A execução pede confirmação antes da cobrança.
Execute a requisição para ver a resposta aqui.
Exemplos de requisição
curl -X POST 'https://api.apifordevs.com/api/v1/cpf/lookup?summary=true' \ -u "afd_live_pk_...:$APIFORDEVS_LIVE_SECRET" \ -H 'X-Project-Id: proj_...' \ -H 'Content-Type: application/json' \ -d '{"cpf":"52998224725","birth_date":"1990-03-15"}'Exemplo de resposta
CpfLookupOutput{ "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 } ]}Códigos de resposta
| Status | errors[].code | Quando acontece | Cobrança |
|---|---|---|---|
| 200 | — | Sucesso. CPF sem cadastro na Receita também é `200`, com `found: false`, e é cobrado. | Sim |
| 400 | birth_date_required | O CPF só pode ser conferido com a data de nascimento: envie `birth_date`. Não é cobrada. | Não |
| 401 | unauthorized | Credencial ausente, inválida ou revogada. | Não |
| 402 | payment_required | Saldo insuficiente ou limite de gasto diário atingido. | Não |
| 403 | forbidden, ip_not_allowed, test_key_cannot_run_live | E-mail da conta não verificado, chave sem escopo para o serviço, IP fora da allowlist do projeto ou chave de teste sem `dev_mode=true`. | Não |
| 409 | conflict | Requisição com a mesma `Idempotency-Key` ainda em andamento. | Não |
| 422 | validation_error | CPF com dígito verificador inválido ou data de nascimento fora do formato. Não é cobrada. | Não |
| 429 | rate_limit_exceeded | Limite de requisições por minuto da chave atingido. | Não |
| 500 | internal_error | Falha interna. | Não |
| 503 | service_unavailable, upstream_error | Serviço desativado (`service_unavailable`), ou a consulta do CPF não respondeu a tempo (`upstream_error`). Não é cobrada; com `upstream_error`, pode ser repetida. | Não |
Preço por consultaR$ 0,35