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 campo service 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.
Nos exemplos de curl, {base_url} representa a URL do ambiente escolhido: Exemplo de requisição:
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ódigos service, campos principais e exemplos mais extensos de request e response.
O catálogo mostra o nome funcional e o alias documentado do service. Se o produto do cliente tiver sido configurado com alias curto, use o alias do produto no campo service. Isso evita erro de acesso mesmo quando o produto está ativo.
Passo rápido para evitar erro:
  1. Abra o produto do cliente no Backoffice.
  2. Confirme o alias liberado para o serviço.
  3. Envie esse alias no campo service.
  4. 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 objeto status que indica o status da consulta. Esse objeto apresenta os atributos code e message, usados para interpretar o processamento técnico.
Para detalhes de tratamento, consulte Status e erros.

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 endpoint POST /api/service-api, mas podem ter respostas mais amplas conforme a disponibilidade dos dados na consulta.
O alias SEVICE_ONLINE_BETTING_PROPENSITY está documentado sem a letra R em SERVICE porque essa é a grafia implementada no backend. Não altere essa grafia sem validação técnica, pois a chamada pode deixar de ser reconhecida.

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.
Autorização:
Body:
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

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.
Autorização:
Body:
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

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.
Exemplo de resposta:

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.
Exemplo de resposta:

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.
Exemplo de resposta:

OCR React

Use SERVICE_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.
Autorização:
Body:
Tipos de documento suportados: Para respostas completas por tipo de documento, consulte Documentos de identificação. Exemplo com curl:
Exemplo de resposta:

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.
Autorização:
Body:
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

Pessoa politicamente exposta

Consulta o CPF de um indivíduo e retorna se a pessoa é politicamente exposta.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

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.
Campos principais do retorno: 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.
Campos principais do retorno: 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).
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

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.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

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.
Campos principais do retorno: 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.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

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:
Exemplo de resposta:

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.
Exemplo de resposta:
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.
Parâmetros opcionais: Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

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 como NADA CONSTA.
Exemplo com curl:
Exemplo de resposta:

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 como NADA CONSTA. Quando houver antecedentes, a descrição dos registros não é retornada por essa consulta.
Parâmetros aceitos: 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:
Exemplo de resposta:

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.
Exemplo com curl:
Exemplo de resposta:

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.
Status possíveis: Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

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:
Exemplo de resposta:

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.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

Consulta de informações financeiras

Consulta informações financeiras associadas ao CPF informado.
Autorização:
Body:
Exemplo com curl:
Esse serviço não possui exemplo de body de resposta JSON nesta referência.

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).
Autorização:
Body:
Exemplo com curl:
Esse serviço aparece como indisponível nesta referência e não possui body de resposta documentado.

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.
Autorização:
Body:
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

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 de entrada: Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

Consulta do resultado da documentoscopia digital

Consulta o resultado da documentoscopia digital usando a chave informada na requisição de criação.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

Consulta de MEI

Consulta os MEIs que um CPF possui.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

Processos jurídicos e administrativos

Consulta processos jurídicos e administrativos associados ao CPF informado.
Exemplo com curl:
Exemplo de resposta:

Consulta de servidores públicos

Consulta vínculos relacionados a servidores públicos para o CPF informado.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

Consulta de endereços

Consulta endereços associados ao CPF informado.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

Consulta de relacionamentos econômicos

Consulta relacionamentos econômicos associados ao CPF informado.
Exemplo com curl:
O retorno desse serviço não foi informado no trecho atual da documentação antiga.

Consulta do histórico profissional

Consulta histórico profissional associado ao CPF informado.
Exemplo com curl:
Exemplo de resposta:

Consulta de dados pelo telefone

Consulta dados da pessoa a partir do telefone informado.
Exemplo com curl:
Exemplo de resposta:

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.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

Consulta de doações eleitorais

Consulta doações eleitorais realizadas por uma pessoa.
Campos principais do retorno: Exemplo com curl:
Exemplo de resposta:

Consulta de envolvimento político

Consulta indicadores de envolvimento político de uma pessoa.
Exemplo com curl:
Exemplo de resposta:

Consulta de histórico familiar político

Consulta histórico político familiar de uma pessoa.
Campos principais do retorno:
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:

Consulta de prestadores de serviço eleitorais

Consulta prestadores de serviço eleitorais associados à pessoa.
Campos principais do retorno: