Perguntas Frequentes

O que a API da CPFHub retorna?

Nome completo, gênero e data de nascimento a partir do CPF. Consulta individual (GET) e lote (POST bulk). Não retorna score, situação na Receita nem e-mail.

A CPFHub consulta a Receita Federal ao vivo?

Não. Não fazemos consulta live no site da Receita nem devolvemos situação cadastral RF. Entregamos dados cadastrais básicos (nome, gênero, nascimento) via API.

Dá para validar CPF e nome no cadastro?

Sim: você envia o CPF, recebe nome e nascimento, e compara com o que o usuário digitou no seu fluxo (antifraude/cadastro). A regra de match fica no seu sistema.

Tem consulta em lote?

Sim. Endpoint de bulk assíncrono (até 10.000 CPFs por requisição). Útil para limpar base. Detalhes e autenticação na documentação.

A CPFHub faz KYC com selfie ou OCR?

Não. Produto live é só consulta de CPF (GET + lote). Sem biometria, selfie ou OCR de documento.

Qual o SLA?

Por plano, em /precos: Grátis 95%, Pro 99%, Corporativo 99,9%. Não publicamos latência fixa em ms.

Como obtenho minha API Key?

Ao criar sua conta, uma API Key já é gerada automaticamente. Acesse app.cpfhub.io/api-keys para visualizá-la e copiá-la a qualquer momento. Se precisar, você pode gerar uma nova chave nessa mesma página.

O plano gratuito tem limite de consultas?

Sim. O plano gratuito inclui 50 consultas por mês. Planos pagos oferecem volumes maiores e rate limits mais altos. Veja os planos disponíveis no painel.

Existe um ambiente sandbox para testes?

Não oferecemos um ambiente sandbox separado. Em vez disso, toda conta inclui 50 consultas gratuitas por mês: use-as para testar sua integração em produção sem custo. CPFs não encontrados (404) e CPFs inválidos (400/422) nunca consomem créditos, então você pode testar cenários de erro à vontade.

O que acontece quando o CPF não é encontrado?

A API retorna HTTP 404 com o código CPF_NOT_FOUND. Essa consulta não desconta créditos do seu plano: você só paga por consultas bem-sucedidas.

CPFs inválidos também consomem crédito?

Não. Consultas que retornam INVALID_CPF_FORMAT ou INVALID_CPF_DIGITS (dígitos verificadores errados) não consomem créditos. Apenas respostas 200 OK são cobradas.

A API armazena os CPFs consultados?

O CPFHub.io não armazena logs de consultas vinculados ao CPF pesquisado. Os dados retornados são provenientes de fontes públicas e são processados em memória. Consulte nossa política de compliance para detalhes completos.

A API é compatível com a LGPD?

Sim. A API consulta apenas dados de fontes públicas e não retorna informações sensíveis além do nome, gênero e data de nascimento. O uso é permitido para finalidades legítimas de verificação de identidade, KYC e prevenção de fraudes.

Qual é o tempo de resposta médio?

Não publicamos número de latência. O SLA de disponibilidade varia por plano: Grátis 95%, Pro 99%, Corporativo 99,9%. Consulte /precos e o status em app.cpfhub.io/status.

Posso usar a API no frontend (browser)?

Tecnicamente sim, mas não é recomendado. Expor sua API Key no código client-side é um risco de segurança. Sempre faça as chamadas em um backend (servidor, serverless function, API Route no Next.js) e nunca inclua a chave em código público.

O rate limit é por segundo ou por minuto?

O Grátis permite 1 requisição a cada 2 segundos. O plano Pro permite 1 requisição por segundo. Corporativo tem limite sob consulta. Ao exceder, a API retorna 429 com o header Retry-After indicando quantos segundos aguardar.

Existe SDK para minha linguagem?

Temos SDKs oficiais para 13 linguagens: Node.js, Python, Go, PHP, Java, Ruby, Rust, .NET/C#, Dart, Swift, Elixir, Lua e Nim. Todos com tipagem completa e exemplos prontos para produção.

Como cancelo minha assinatura?

Acesse o painel em app.cpfhub.io, vá em Configurações → Assinatura e clique em Cancelar plano. A solicitação de cancelamento é processada imediatamente; você mantém o acesso ao plano até o fim do período já pago.

O CPFHub.io tem suporte técnico?

Sim. Clientes com planos pagos têm acesso a suporte por email com SLA de resposta em até 24 horas úteis. Para dúvidas rápidas, a documentação e o playground cobrem a maioria dos casos.