Descrição
O dataset de Dados Cadastrais fornece uma série de informações sobre um indivíduo, que são comumente requisitadas em procedimentos de cadastro de pessoas nas mais diversas plataformas e serviços. Além dos dados básicos, contendo dados como nome, data de nascimento e nome da mãe, também são entregues dados de e-mails, endereços e telefones.
Origem da Informação
Os dados deste dataset são capturados através das ocorrências de associação de contatos e endereços com a pessoa consultada, a partir de fontes públicas disponíveis na internet.
Tabela de preços para esse dataset
| Consultas Realizadas no Mês | Valor por consulta |
|---|---|
| 1 - 10000 | R$ 0,120 |
| 10001 - 50000 | R$ 0,114 |
| 50001 - 100000 | R$ 0,108 |
| 100001 - 500000 | R$ 0,103 |
| 500001 - 1000000 | R$ 0,098 |
| 1000001 - 5000000 | R$ 79,000.00 (preço fixo) |
| 5000001 e acima | Entre em contato |
Parâmetros de consulta
A tabela abaixo detalha os campos aceitos na consulta a este dataset.
| Campo | Descrição | Valores Possíveis | Tipo de Campo |
|---|---|---|---|
| doc | Documento de identificação | CPF | 🛑 Obrigatório |
| birthdate | Data de Nascimento | yyyy-MM-dd | ℹ️ Opcional |
| dateformat | Formato da Data | yyyy-MM-dd, dd/MM/yyyy | ℹ️ Opcional |
Clique aqui para saber mais sobre os parâmetros de consulta da Plataforma de Dados.
Abaixo está um exemplo de como realizar a chamada apenas com os parâmetros obrigatórios:
{
"Datasets": "registration_data",
"q": "doc{CPF}"
}
Descrição dos campos do objeto principal de retorno
| Campo | Descrição |
|---|---|
| BasicData | Objeto contendo dados básicos como nome, nascimento e nome da mãe |
| Emails | Objeto contendo os dados de e-mail principal e secundário do indivíduo |
| Addresses | Objeto contendo os dados de endereço principal e secundário do indivíduo |
| Phones | Objeto contendo os dados dos telefones principal e secundário do indivíduo |
Retorno de Datas de Nascimento Inválidas
De acordo com os dados da Receita Federal, alguns indivíduos possuem datas de nascimento inválidas, impossibilitando sua formatação para o campo BirthDate. Nesses casos, o indicador IsValidBirthDateInRFSource será false, e o campo CapturedBirthDateFromRFSource retornará a data capturada na Receita Federal, sempre no formato yyyy-MM-dd.
Uma data é considerada inválida quando não existe no calendário, como:
- Dias além do limite do mês (ex.: 2023-04-31, já que abril tem apenas 30 dias).
- 29 de fevereiro em anos que não são bissextos (ex.: 2002-02-29, 1987-02-29).