Descrição
O dataset de Histórico de Dados Básicos fornece uma visão temporal de todas as mudanças de nome e status de uma pessoa física na Receita Federal. Esse tipo de informação estendida pode ser utilizada desde refinar modelos de score de crédito até processos de background check no onboarding de novos clientes. Para casos de menores de idade ou de documentos não cobertos pela base de dados interna, esse dataset não retornará quaisquer dados. Também é assumido por essa consulta que a data da primeira mudança de nome e status começa a partir dos 18 anos (maioridade penal) de uma pessoa física.
Origem da Informação
Todos os dados fornecidos por esta consulta são capturados através de monitoramentos periódicos de documentos na Receita Federal, documentos estes que são obtidos através de vias públicas desta fonte.
Tabela de preços para esse dataset
| Consultas Realizadas no Mês | Valor por consulta |
|---|---|
| 1 - 10000 | R$ 0,030 |
| 10001 - 50000 | R$ 0,028 |
| 50001 - 100000 | R$ 0,027 |
| 100001 - 500000 | R$ 0,026 |
| 500001 - 1000000 | R$ 0,025 |
| 1000001 - 5000000 | R$ 21.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 |
| name | Possibilita a comparação de um nome informado na entrada com o nome encontrado na base, além do retorno do percentual de similaridade entre os dois. | Qualquer texto | ℹ️ Opcional |
| mothername | Possibilita a comparação de um nome da mãe informado na entrada com o nome da mãe encontrado na base, além do retorno do percentual de similaridade entre os dois. | Qualquer texto | ℹ️ Opcional |
| birthdate | Possibilita a comparação de uma data de nascimento informada na entrada com a data de nascimento encontrada na base, além do retorno de um flag indicando se as datas são iguais ou não. Além da data, pode ser passado, também, um segundo parâmetro chamado dateformat contendo o formato da data, como "dd-mm-yyyy", por exemplo. | Qualquer data válida | ℹ️ Opcional |
| dateformat | Formato da data de referência informada | String de formatação da data, como yyyy-MM-dd ou similar | ℹ️ 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": "historical_basic_data",
"q": "doc{CPF}"
}
Alguns campos, como o status do CPF na Receita Federal e o Gênero, têm valores predefinidos. Os valores possíveis para esses campos seguem abaixo.
| Campo | Valores Possíveis |
|---|---|
| Status | CANCELADA, CPF COM DADOS INCOMPLETOS, INVALID DOCUMENT, NULA, PENDENTE DE REGULARIZACAO, REGULAR, SUSPENSA, TITULAR FALECIDO |
| Gender | M, F, U |