Enriquecimento cadastral

Use estes serviços para validar dados de CPF, complementar cadastros e confirmar associações entre uma pessoa e seus dados de contato. Eles apoiam onboarding, atualização cadastral, prevenção à fraude, análise operacional e qualificação de bases. Todos os serviços desta categoria são consumidos pelo endpoint:

POST /api/service-api

O serviço executado é definido pelo campo service.

Quando usar

Use esta categoria quando precisar:

validar se um CPF está regular na Receita Federal;
enriquecer dados cadastrais de uma pessoa física;
confirmar dados associados a telefone, endereço ou e-mail;
consultar informações complementares como MEI, PIS, E-Social, Cartão SUS, endereços e relacionamentos econômicos.

Serviços disponíveis

Serviço	Código `service`	Uso principal
Enriquecimento de dados de PF	`SERVICE_PERSON_DATA_ENRICHMENT`	Retorna dados cadastrais, status, filiação, nascimento, região fiscal e indicadores de unicidade do nome
Status do CPF na Receita Federal	`SERVICE_RFB_PF`	Consulta situação cadastral do CPF, data de nascimento, óbito e origem da informação
CPF na Receita Federal on-demand	`SERVICE_RFB_PF_ON_DEMAND`	Busca ou atualiza dados cadastrais do CPF no momento da requisição
Modelagem de dados de pessoa física	`SERVICE_PERSON_DATA_MODELING`	Consolida dados cadastrais, contatos, vínculos, processos e endereços em uma visão textual
Prompt de IA para pessoa	`SERVICE_PERSON_AI_PROMPT`	Gera uma leitura analítica dos dados consolidados da pessoa consultada
Validação de e-mail	`SERVICE_EMAIL_VALIDATION`	Verifica validade, normalização, risco, domínio descartável, spam trap e características do endereço
Validação de CPF com telefone	`SERVICE_CPF_PHONE_VALIDATION`	Verifica associação entre CPF e telefone e retorna taxa de correspondência
Validação de CPF com endereço	`SERVICE_CPF_ADDRESS_VALIDATION`	Verifica associação entre CPF, CEP e número do endereço
Consulta de MEI	`SERVICE_MEI`	Retorna empresas MEI associadas ao CPF
Dados PIS	`SERVICE_PIS_CONSULTATION`	Consulta dados do Programa de Integração Social quando disponível
Cartão SUS	`SERVICE_ONDEMAND_SUS_CARD_PERSON_CPF`	Retorna os dados do Cartão Nacional de Saúde localizados para o CPF, com número do cartão, data de captura e dados de nascimento
Validação E-Social	`SERVICE_ESOCIAL_REGISTRATION_QUALIFICATION`	Valida qualificação cadastral no E-Social, com CPF, nome, nascimento e PIS
Consulta de endereços	`SERVICE_ADDRESS`	Retorna endereços associados ao CPF
Dados pelo telefone	`SERVICE_CONFIRM_PHONE`	Retorna dados de pessoa a partir de telefone
Histórico de telefones	`SERVICE_PHONE_HISTORY`	Retorna telefones associados ao CPF, tipo de linha e indicação de recência
Histórico de e-mails	`SERVICE_EMAILS_EXTENDED`	Retorna e-mails associados ao CPF e sinais de uso, validação e prioridade
Pessoas relacionadas	`SERVICE_RELATED_PEOPLE`	Retorna pessoas relacionadas ao CPF e o tipo de relacionamento identificado
E-mails de Pessoas Relacionadas	`SERVICE_RELATED_PEOPLE_EMAILS`	Retorna e-mails de pessoas relacionadas ao CPF, com o relacionamento identificado
Telefones de Pessoas Relacionadas	`SERVICE_RELATED_PEOPLE_PHONES`	Retorna telefones de pessoas relacionadas ao CPF, com o relacionamento identificado
Endereços de Pessoas Relacionadas	`SERVICE_RELATED_PEOPLE_ADDRESSES`	Retorna endereços de pessoas relacionadas ao CNPJ, com o relacionamento identificado
TSE - Local de votação	`SERVICE_ONDEMAND_TSE_POLLING_PLACE_PERSON_CPF`	Retorna local de votação, situação eleitoral e biometria atual no TSE
Relacionamentos econômicos	`SERVICE_ECONOMIC_RELATIONSHIP`	Retorna vínculos econômicos associados ao CPF
Histórico profissional	`SERVICE_PROFESSIONAL_HISTORY`	Consulta vínculos e histórico profissional
Histórico profissional do titular	`SERVICE_PROFESSIONAL_HISTORY_OWNER_ONLY`	Retorna vínculos profissionais em que a pessoa aparece como titular ou sócia
Dados financeiros e endereços PF	`SERVICE_PF_FINANCIAL_AND_ADDRESS`	Combina dados cadastrais, endereços e informações financeiras em uma única consulta

Exemplo rápido

Consulta de enriquecimento cadastral de pessoa física:

curl --location '{base_url}/api/service-api' \
  --header 'Authorization: Bearer {jwt_token}' \
  --header 'Content-Type: application/json' \
  --data '{
    "service": "SERVICE_PERSON_DATA_ENRICHMENT",
    "cpf": "cpf"
  }'

Payload:

{
  "service": "SERVICE_PERSON_DATA_ENRICHMENT",
  "cpf": "cpf"
}

Resposta esperada:

{
  "result": {
    "cpf": "00000000000",
    "status": "REGULAR",
    "name": "NOME DA PESSOA",
    "birthDate": "1998-07-05",
    "origin": "RECEITA FEDERAL",
    "age": 24
  },
  "status": {
    "code": 200,
    "message": "Success"
  }
}

Como combinar os serviços

Uma validação cadastral simples costuma começar com SERVICE_RFB_PF. Para uma visão mais completa, use SERVICE_PERSON_DATA_ENRICHMENT. Quando o objetivo for validar contato ou entrega, combine as consultas de e-mail, telefone e endereço.

Próximo passo

API Reference

Contrato completo: campos, exemplos e responses de cada serviço.

Catálogo técnico de Pessoa Física

Todos os services de pessoa física em um único catálogo.

Escolha o serviço certo

Ainda em dúvida sobre qual service usar? Comece por aqui.

Primeiros passos

Fluxos principais

Suporte e referência

POST /api/service-api

Pessoas

Empresas

Catálogo técnico

Enriquecimento cadastral

Enriquecimento cadastral

Quando usar

Serviços disponíveis

Exemplo rápido

Como combinar os serviços

Próximo passo

API Reference

Catálogo técnico de Pessoa Física

Escolha o serviço certo

​Enriquecimento cadastral

​Quando usar

​Serviços disponíveis

​Exemplo rápido

​Como combinar os serviços

​Próximo passo

API Reference

Catálogo técnico de Pessoa Física

Escolha o serviço certo

Enriquecimento cadastral

Quando usar

Serviços disponíveis

Exemplo rápido

Como combinar os serviços

Próximo passo