Serviços de Pessoa Física
Os serviços de pessoa física permitem consultar, validar e enriquecer dados de CPF em fluxos de onboarding, KYC, prevenção à fraude, análise cadastral, biometria, documentos, compliance e dados eleitorais. Todos são executados pelo endpoint central de serviços. O camposervice
define qual produto será processado, e os demais campos variam conforme a
consulta escolhida.
Antes de montar o body, confira no produto do cliente qual alias está liberado.
Esse é o valor que deve ir no campo service.
curl, {base_url} representa a URL do ambiente escolhido:
Exemplo de requisição:
Como usar este catálogo
Esta é a referência técnica completa de pessoa física — use-a quando precisar do contrato completo de um service. Para navegar por objetivo ou família de produto primeiro, veja Escolha o serviço certo, Matriz de serviços ou Famílias de serviços. Use esta página para consultar a lista completa de serviços de CPF, seus códigosservice, campos principais e exemplos mais extensos de request e response.
Passo rápido para evitar erro:
- Abra o produto do cliente no Backoffice.
- Confirme o alias liberado para o serviço.
- Envie esse alias no campo
service. - Use os demais campos da tabela como entrada principal da consulta.
OCR, documentoscopia, FaceMatch e Liveness precisam de imagem/base64, URL ou
key real para retornar dados completos. Payload curto ajuda a validar
autenticação, acesso ao produto e formato básico da chamada, mas não valida o
retorno completo do processamento.Guias relacionados
Status e erros
No retorno das consultas, a API inclui um objetostatus que indica o status da
consulta. Esse objeto apresenta os atributos code e message, usados para
interpretar o processamento técnico.
Serviços disponíveis
Cadastro e identidade
Biometria e documentos
Risco, compliance e validações
Consultas avançadas adicionadas
Alguns serviços retornam informações consolidadas ou análises derivadas de fontes complementares. Eles seguem o mesmo padrão de chamada do endpointPOST /api/service-api, mas podem ter respostas mais amplas conforme a
disponibilidade dos dados na consulta.
Exemplos
Enriquecimento de dados de pessoa física
A consulta de enriquecimento de dados de pessoa física retorna informações de uma pessoa física existente no site da Receita Federal. O retorno pode incluir status cadastral, protocolo da consulta, indicação de óbito quando disponível e outras informações relacionadas ao CPF consultado. As informações dessa consulta são obtidas a partir da consulta pública de pessoa física no site da Receita Federal.
Exemplo com
curl:
Status do CPF na Receita Federal
A consulta de status do CPF na Receita Federal retorna a situação cadastral de um CPF existente na base pública da Receita Federal.
Exemplo com
curl:
CPF na Receita Federal on-demand
Executa a consulta do CPF na Receita Federal em modo on-demand. Use quando for necessário buscar ou atualizar os dados cadastrais diretamente no momento da requisição.Modelagem de dados de pessoa física
Consolida informações de modelagem, histórico de telefones, processos, relacionamentos econômicos, histórico profissional e endereços para apoiar análises mais completas de uma pessoa.Prompt de IA para pessoa
Gera um resumo analítico a partir de dados consolidados da pessoa consultada. Esse serviço é útil quando a integração precisa transformar múltiplos sinais em uma explicação textual estruturada.OCR React
UseSERVICE_OCR para extrair dados de documentos de identificação como RG/CIN,
CNH, OAB, RNE/CRNM e PASSAPORTE. Para deixar a API identificar o documento,
envie documentType: IDENTIFICATION_DOCUMENT.
Para respostas completas por tipo de documento, consulte
Documentos de identificação.
Exemplo com
curl:
FaceMatch
Esse serviço compara duas imagens e retorna a similaridade entre as pessoas nas imagens. As imagens podem ser enviadas em base64 ou por URL, conforme a integração.
Exemplo com
curl:
Pessoa politicamente exposta
Consulta o CPF de um indivíduo e retorna se a pessoa é politicamente exposta.
Exemplo com
curl:
KYC e compliance de pessoa física
Consolida sinais de compliance de uma pessoa física, incluindo exposição PEP, sanções atuais e histórico de ocorrências encontradas nas bases consultadas.
Exemplo de resposta:
Exposição e perfil na mídia de pessoa física
Consulta exposição pública e perfil de mídia associado ao CPF, incluindo nível de exposição, celebridade, impopularidade, unicidade do nome e notícias relacionadas quando disponíveis.
Exemplo de resposta:
Dívida ativa - Pessoa Física
Consulta a situação dos débitos relativos a créditos tributários federais e à Dívida Ativa da União, disponível na Receita Federal e na Procuradoria-Geral da Fazenda Nacional (PGFN).
Exemplo com
curl:
Score de risco de fraude
O score de risco de fraude mede a propensão de fraude de uma interação associada a um CPF. Essa propensão é calculada a partir de inferência estatística baseada em informações históricas de fraude e apoia decisões de prevenção à fraude e análise de risco.
Exemplo com
curl:
Risco financeiro
Calcula um score de risco financeiro para o CPF informado. A resposta retorna o score normalizado e uma mensagem com a leitura resumida da análise.
Exemplo de resposta:
Score de inadimplência
O score de inadimplência identifica o nível de risco de inadimplência de um cliente ou prospecto. O resultado varia de 0 a 1000; quanto maior o valor, menor o risco de inadimplência.
Exemplo com
curl:
Score biométrico
A consulta de score biométrico compara um CPF e uma selfie com imagens presentes em bases do Governo Federal, como CPF, CNPJ e CNH. O retorno indica o índice de similaridade encontrado.
Exemplo com
curl:
Validação de CNH no DataValid
Valida dados de CNH com apoio do validação documental. O serviço recebe o CPF e a imagem de referência, normalmente em base64, para executar a validação disponível na integração.Atualmente, o retorno exposto por este serviço pode ser mínimo e variar
conforme a disponibilidade da integração validação documental. Use o status da
chamada e os campos retornados em
result como contrato efetivo da resposta.Certidão de Nada Consta - Ações Judiciais
Emite uma certidão de Nada Consta em tribunais regionais federais. Na esfera eleitoral, a consulta está disponível apenas para fontes do TRF1 e TRF4.
Campos principais do retorno:
Exemplo com
curl:
Certidão de antecedentes criminais - Federal
Emite uma certidão de antecedentes criminais junto à Polícia Federal. Quando não há antecedentes, o status do resultado retorna comoNADA CONSTA.
Exemplo com
curl:
Certidão de antecedentes criminais - Civil
Emite uma certidão de antecedentes criminais junto à Polícia Civil do estado consultado. Caso a pessoa não possua antecedentes, o status do resultado retorna comoNADA CONSTA. Quando houver antecedentes, a descrição dos registros não é
retornada por essa consulta.
Obrigatoriedade de parâmetros por estado:
Estados disponíveis para consulta:
BA, CE, ES, MG, MS, MT, PA,
PE, RJ, RR, RS, SE e SP.
Campos principais do retorno:
Exemplo com
curl:
Certidão negativa de protesto
Consulta informações de protestos em cartórios. Quando não existem protestos de títulos contra o indivíduo, retorna uma certidão emitida pelo Instituto de Estudos de Protestos de Títulos do Brasil.curl:
Validação de e-mail
Realiza uma verificação em tempo real do e-mail informado, aplicada a cenários como prevenção à fraude, identificação correta de e-mail, marketing, campanhas e envio de cobranças.
Campos principais do retorno:
Exemplo com
curl:
Validação de CPF com telefone
Verifica a associação entre CPF e número de telefone nas principais operadoras do Brasil. Esse serviço pode apoiar redução de custos e validações antes de envios de mensagens.
Exemplo com
curl:
Validação de CPF com endereço
Valida a associação entre CPF e endereço nas principais operadoras de telefonia do Brasil. Essa consulta ajuda a verificar se o indivíduo está associado ao endereço informado e também apoia verificações relacionadas à localização.
Exemplo com
curl:
Consulta de informações financeiras
Consulta informações financeiras associadas ao CPF informado.curl:
Consulta de dados PIS
A consulta de dados do PIS busca informações do Programa de Integração Social disponíveis no portal do Cadastro Nacional de Informações Sociais (CNIS).curl:
Validação do E-Social
A validação do E-Social consulta o status cadastral do indivíduo no E-Social. Embora a consulta possa usar o NIT, esse campo não é obrigatório. Caso o NIT não seja enviado, a API utiliza o dado disponível na base.
Exemplo com
curl:
Documentoscopia digital
Esse serviço realiza a extração das informações do documento enviado e executa FaceMatch entre a selfie informada e o documento, podendo também comparar com bases do governo.
Campos principais do retorno:
Exemplo com
curl:
Consulta do resultado da documentoscopia digital
Consulta o resultado da documentoscopia digital usando a chave informada na requisição de criação.
Exemplo com
curl:
Consulta de MEI
Consulta os MEIs que um CPF possui.
Exemplo com
curl:
Processos jurídicos e administrativos
Consulta processos jurídicos e administrativos associados ao CPF informado.curl:
Consulta de servidores públicos
Consulta vínculos relacionados a servidores públicos para o CPF informado.
Exemplo com
curl:
Consulta de endereços
Consulta endereços associados ao CPF informado.
Exemplo com
curl:
Consulta de relacionamentos econômicos
Consulta relacionamentos econômicos associados ao CPF informado.curl:
Consulta do histórico profissional
Consulta histórico profissional associado ao CPF informado.curl:
Consulta de dados pelo telefone
Consulta dados da pessoa a partir do telefone informado.
Exemplo com
curl:
Consulta de mandado de prisão
Consulta mandado de prisão associado aos dados informados.Consulta de débitos ativos
Consulta débitos ativos associados ao CPF informado.Consulta de dados eleitorais de um candidato
Consulta dados eleitorais associados a um candidato.
Exemplo com
curl:
Consulta de doações eleitorais
Consulta doações eleitorais realizadas por uma pessoa.
Exemplo com
curl:
Consulta de envolvimento político
Consulta indicadores de envolvimento político de uma pessoa.
Exemplo com
curl:
Consulta de histórico familiar político
Consulta histórico político familiar de uma pessoa.Alguns campos abaixo mantêm a grafia original retornada pela API, mesmo quando
ela parece inconsistente. Isso evita divergência entre a documentação e o
contrato real do response.
Exemplo de resposta:
