Situação do CPF
Situação cadastral do CPF na Receita Federal (regular, suspensa, cancelada…), com nome, data de inscrição e código de controle. Exige a data de nascimento.
Resumo
| Item | Valor |
|---|---|
| Identificador técnico | situacao-cpf |
| Dados exigidos | documento (CPF) + data_nascimento (dd/mm/aaaa) (no catálogo: documento, data_nascimento) |
| O que devolve | JSON da Receita Federal + PDF |
| Preço vigente | R$ 1,99. Com a sua chave, GET /v1/servicos traz o seu preço. |
| Prazo | Poucos minutos. |
| Bloco veiculo | Não |
| Observação | Dado de pessoa (CPF): exige finalidade declarada e fica registrado quem consultou, quando e para quê. |
Requisição
Pelo endpoint comum de consultas, POST /v1/consultas. Os valores do exemplo são fictícios.
curl -X POST "https://api.zapcarconsulta.com.br/v1/consultas" \
-H "Authorization: Bearer $ZAPCAR_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: pedido-erp-984281-situacao-cpf" \
-d '{"servico":"situacao-cpf","documento":"12345678909","data_nascimento":"01/01/1990"}'Resposta
O POST devolve 201 com o id e status: "processando". O resultado sai em GET /v1/consultas/{id}, que passa por um destes estados:
| status | O que vem |
|---|---|
| processando | Só o envelope. Consulte de novo em 3 a 5 s. |
| concluido | dados e pdf_url. |
| erro | Valor estornado. erro_codigo diz o motivo e retryable se vale criar uma consulta nova. |
Campo dados
No formato da base consultada (camada de espelho): nomes e preenchimento acompanham a fonte. Para dado com forma garantida, use o bloco veiculo quando o serviço tiver.
{
"nome": "FULANO DE TAL",
"cpf": "123.456.789-09",
"data_nascimento": "1990-01-01",
"data_inscricao": "2008-03-10",
"situacao": "Regular",
"digito_verificador": "00",
"codigo_controle": "ABCD.1234.EF56.7890"
}Particularidades
- documento só aceita CPF. data_nascimento em dd/mm/aaaa é obrigatória: inválida ou ausente, 400 DATA_NASCIMENTO_INVALIDA antes de cobrar.
- A Receita só responde quando CPF e data batem. Se não conferirem, a consulta termina em erro com retryable: false e o valor volta ao saldo.
- A situação vem em dados.situacao (Regular, Suspensa, Cancelada, Pendente de Regularização…).
No sandbox
Valida o CPF e a data_nascimento como a produção. dados fictício no formato do serviço, sem bloco veiculo. Os cenários TST0404/TST0503 não se aplicam (não há placa).
Cobrança
Debitado no POST, antes do processamento, e estornado automaticamente se a consulta terminar em erro. Pedido recusado na validação (400, 402, 409, 422) não cobra. Ler o resultado e baixar o documento são gratuitos. Ver Cobrança e estorno.
Dado pessoal
Testar no sandbox: abrir no API Explorer. Base da API: https://api.zapcarconsulta.com.br.