📂 Estrutura de Dados — Pessoa Física

Esta página descreve todos os campos possíveis na resposta do endpoint Dossiê Cadastral por CPF.

Campos sem valor são omitidos da resposta. Trate sempre com null-safety.

Identificação

Campo	Tipo	Descrição
`cpf`	string	CPF consultado (11 dígitos)
`documento`	string	Mesmo valor que `cpf`
`nome`	string	Nome completo da pessoa física
`nomeMae`	string	Nome da mãe
`dataNascimento`	string	Data de nascimento no formato `YYYY-MM-DD`
`idade`	integer	Idade em anos completos
`sexo`	string	`MASCULINO` ou `FEMININO`
`signo`	string	Signo zodiacal (ex: `ARIES`, `CAPRICORNIO`)
`escolaridade`	string	Nível de escolaridade (ex: `SUPERIOR COMPLETO`, `ENSINO MEDIO`)
`obito`	boolean	`true` se há registro de falecimento

Situação Cadastral na Receita Federal

Campo	Tipo	Descrição
`situacaoCadastralRF`	string	Status do CPF na Receita Federal: `REGULAR`, `SUSPENSA`, `TITULAR FALECIDO`, `PENDENTE DE REGULARIZAÇÃO`, `CANCELADA POR ENCERRAMENTO`, `NULA`, `CANCELADA DE OFÍCIO`
`dataSituacaoCadastralRF`	string	Data da última atualização da situação cadastral no formato `YYYY-MM-DD`

Renda Presumida

Campo	Tipo	Descrição
`rendaPresumida`	object	Estimativa de renda
`rendaPresumida.faixaRenda`	string	Faixa de renda (ex: `B (ENTRE 10 E 20 SM)`)
`rendaPresumida.valorRenda`	number	Valor estimado da renda mensal em reais

Contato

Campo	Tipo	Descrição
`telefones`	array	Lista de telefones associados
`telefones[].tipo`	string	Tipo do telefone: `MOVEL`, `FIXO` ou `COMERCIAL`
`telefones[].ddd`	string	DDD (2 dígitos)
`telefones[].numero`	string	Número do telefone (sem DDD)
`emails`	array<string>	Lista de e-mails associados

Endereços

Campo	Tipo	Descrição
`enderecos`	array	Histórico de endereços
`enderecos[].logradouro`	string	Logradouro (rua, avenida, etc.)
`enderecos[].numero`	string	Número
`enderecos[].complemento`	string	Complemento (quando disponível)
`enderecos[].bairro`	string	Bairro
`enderecos[].cidade`	string	Cidade
`enderecos[].uf`	string	UF (sigla do estado)
`enderecos[].cep`	string	CEP (8 dígitos, sem formatação)

Vínculos Societários

Campo	Tipo	Descrição
`sociedades`	array	Empresas em que a pessoa é sócia ou administradora
`sociedades[].cnpj`	string	CNPJ da empresa
`sociedades[].razaoSocial`	string	Razão social da empresa
`sociedades[].cargo`	string	Cargo na empresa (ex: `SOCIO-ADMINISTRADOR`, `ADMINISTRADOR`)
`sociedades[].dataEntrada`	string	Data de entrada na sociedade no formato `YYYY-MM-DD`
`sociedades[].participacao`	number	Percentual de participação na sociedade (quando disponível)