# Como usar consulta de CPF grátis para verificação de identidade em portarias > Saiba como utilizar a consulta de CPF grátis para verificar visitantes em portarias de condominios, empresas e edificios comerciais de forma automatizada. **Publicado:** 03/06/2026 **Autor:** Redação CPFHub.io **URL:** https://cpfhub.io/blog/como-usar-consulta-de-cpf-gratis-para-verificacao-de-identidade-em-portarias --- A consulta de CPF via API permite que portarias de condominios e edificios comerciais validem a identidade de visitantes em segundos, cruzando o número informado com dados oficiais da Receita Federal. O processo substitui a conferencia manual de documentos por uma verificação automatizada que retorna o nome do titular em ~900ms. Para a maioria dos condominios residenciais, o plano gratuito da CPFHub.io — com 50 consultas mensais — ja e suficiente para começar sem custo. ## Por que validar CPF em portarias ### Seguranca patrimonial Verificar se o CPF informado pelo visitante corresponde ao nome declarado e uma camada adicional de seguranca que dificulta o acesso de pessoas usando identidades falsas. ### Registro auditável de acessos Cada consulta de CPF gera um registro com data e hora, criando um histórico de visitantes que pode ser consultado em caso de incidentes. ### Agilidade no atendimento A verificação automatizada e mais rápida que a conferencia manual de documentos. O porteiro ou o totem de autoatendimento válida o visitante em segundos. ### Conformidade com normas de seguranca Edificios comerciais e condominios de alto padrão frequentemente possuem normas internas que exigem a verificação de identidade de todos os visitantes. A consulta via API atende a essa exigencia. --- ## Cenários de aplicação ### Portaria de condominio residencial O visitante informa o CPF ao porteiro ou digita em um totem. O sistema consulta a API, retorna o nome do titular e o porteiro confirma se confere com a pessoa presente. ### Recepcao de edificio comercial Prestadores de serviço que visitam o edificio regularmente podem ter o CPF pre-cadastrado. Na chegada, basta informar o número para que o sistema confirme a identidade e libere o acesso. ### Controle de acesso em eventos corporativos Empresas que recebem visitantes para reunioes ou eventos podem validar o CPF no momento do check-in, garantindo que apenas pessoas autorizadas acessem as instalacoes. --- ## Exemplo de integração Veja como um sistema de portaria pode consultar o CPF de um visitante usando Node.js: ```javascript const express = require('express'); const app = express(); app.use(express.json()); app.post('/portaria/visitante', async (req, res) => { const { cpf } = req.body; const controller = new AbortController(); setTimeout(() => controller.abort(), 10000); try { const response = await fetch(`https://api.cpfhub.io/cpf/${cpf}`, { method: 'GET', headers: { 'x-api-key': process.env.CPFHUB_API_KEY, 'Accept': 'application/json' }, signal: controller.signal }); const data = await response.json(); if (!data.success) { return res.status(404).json({ erro: 'CPF nao localizado' }); } return res.json({ nome: data.data.name, cpfMascarado: `${cpf.slice(0, 3)}.***.**${cpf[8]}-${cpf.slice(9)}`, horario: new Date().toISOString() }); } catch (error) { return res.status(500).json({ erro: 'Falha na verificacao' }); } }); app.listen(3000); ``` O porteiro visualiza o nome retornado e confirma com o visitante: ```json { "success": true, "data": { "cpf": "12345678900", "name": "Carlos Eduardo Mendes", "nameUpper": "CARLOS EDUARDO MENDES", "gender": "M", "birthDate": "03/11/1988", "day": 3, "month": 11, "year": 1988 } } ``` --- ## Fluxo de verificação em portarias 1. **Visitante chega a portaria** -- Informa o CPF ao porteiro ou digita no totem. 2. **Validação sintatica** -- O sistema verifica o formato do CPF localmente. 3. **Consulta a API** -- O CPF e enviado para a [**CPFHub.io**](https://www.cpfhub.io/) 4. **Exibicao do nome** -- O nome do titular e exibido na tela do porteiro. 5. **Confirmação visual** -- O porteiro compara o nome com o documento do visitante. 6. **Registro do acesso** -- O sistema armazena o registro da visita com data, hora e CPF mascarado. --- ## Boas práticas de seguranca e privacidade * **Mascare o CPF nos registros** -- Armazene apenas versões parciais (ex.: 123.***.**9-00) para conformidade com a LGPD. * **Defina retencao de dados** -- Estabeleca um período máximo para armazenar registros de visitantes (ex.: 90 dias). * **Use HTTPS** -- Todas as comunicacoes com a API ja são criptografadas, mas garanta que seu sistema interno também use conexões seguras. * **Configure timeout** -- Defina 10 segundos como limite para evitar travamentos no fluxo de atendimento. * **Implemente fallback** -- Se a API estiver indisponivel, permita o registro manual com verificação posterior. --- ## Volumes e planos recomendados | Tipo de portaria | Visitantes/mes estimados | Plano recomendado | | --- | --- | --- | | Condominio residencial | Até 50 | Gratuito (R$ 0) | | Edificio comercial medio | 100-500 | Pro (R$ 149/mes) | | Torre corporativa | 1.000+ | Corporativo | O plano gratuito com 50 consultas mensais e ideal para condominios de pequeno porte ou para testar a integração antes de escalar. Ao atingir o limite, a API não bloqueia o acesso — cada consulta adicional é cobrada a R$0,15, sem interrupção no fluxo da portaria. --- ## Perguntas frequentes ### O sistema de portaria precisa de alguma configuração especial para usar a API de CPF? Não. Basta fazer uma chamada GET para `https://api.cpfhub.io/cpf/{CPF}` com o header `x-api-key` contendo sua chave de acesso. A API retorna nome, data de nascimento e status do CPF em ~900ms — tempo suficiente para o porteiro confirmar a identidade antes de liberar a catraca ou o acesso ao elevador. ### O que acontece se o condominio ultrapassar as 50 consultas mensais do plano gratuito? A API da CPFHub.io não bloqueia as consultas ao atingir o limite. Cada verificação adicional é cobrada a R$0,15 de forma automática. Isso garante que a portaria nunca fique sem acesso à validação em dias de maior movimento, como mudanças ou eventos no condominio. ### Como armazenar os dados de visitantes sem violar a LGPD? Guarde apenas o CPF mascarado (ex.: 123.***.**9-00) e o nome do titular nos registros de acesso, nunca o CPF completo. Defina um período de retencao de no máximo 90 dias e documente a base legal para o tratamento. A [ANPD](https://www.gov.br/anpd) orienta que dados de identificação devem ser tratados com o princípio da necessidade. ### A verificação de CPF substitui a conferencia do documento físico na portaria? Não completamente. A consulta de CPF confirma que o número informado corresponde ao nome declarado, mas não garante que a pessoa presente e o titular do documento. O fluxo recomendado e usar a API como primeira camada de validação e manter a conferencia visual do documento como etapa complementar, especialmente em edificios com maior nivel de seguranca. ### Leia também - [Como consultar CPF grátis para empresas de segurança privada](https://cpfhub.io/blog/como-consultar-cpf-gratis-para-empresas-de-seguranca-privada) - [Como evitar bloqueios ao usar APIs de consulta de CPF grátis](https://cpfhub.io/blog/como-evitar-bloqueios-ao-usar-apis-de-consulta-de-cpf-gratis) - [Consulta de CPF grátis: como funciona a limitação de 50 consultas mensais](https://cpfhub.io/blog/consulta-de-cpf-gratis-como-funciona-a-limitacao-de-50-consultas-mensais) - [Como garantir segurança ao usar uma API gratuita de CPF](https://cpfhub.io/blog/como-garantir-seguranca-ao-usar-uma-api-gratuita-de-cpf) --- ## Conclusão A consulta de CPF via API transforma a verificação de identidade em portarias, tornando o processo mais seguro, rápido e rastreável. Seja em condominios residenciais, edificios comerciais ou empresas, a validação automatizada reduz riscos e melhora a experiência de visitantes e moradores. A [**CPFHub.io**](https://www.cpfhub.io/) oferece um plano gratuito com 50 consultas mensais para quem quer começar sem custo, e escala automaticamente conforme o volume cresce. Cadastre-se em [cpfhub.io](https://www.cpfhub.io/)