Antes de começar a usar os datasets do grupo de Dados Básicos, é importante compreender alguns conceitos fundamentais que orientam a interpretação correta das informações retornadas pela API. Esses conceitos — como consultas por chaves alternativas e validações embutidas — ajudam a contextualizar os dados recebidos, permitindo avaliar sua confiabilidade, relevância e atualidade.

A seguir, detalhamos os principais elementos que apoiam essa interpretação.

Consultas por chaves alternativas

Quando a consulta é realizada por uma chave diferente do CPF — como nome + data de nascimento, e-mail, ou outros identificadores disponíveis — o dataset pode retornar múltiplos candidatos, dentro do limite configurado na chamada. Cada candidato representa uma possível correspondência encontrada, permitindo ao consumidor da API avaliar qual registro se adequa melhor ao contexto da busca e seguir com etapas adicionais de verificação. Caso as chaves alternativas fornecidas sejam amplas ou correspondam a um grande número de pessoas, a API não retornará resultados. Nesses casos, é necessário adicionar mais chaves alternativas à consulta para refinar e restringir o conjunto de correspondências.

Validações embutidas

Os datasets de Dados Básicos permitem a utilização de parâmetros opcionais que podem ser utilizados para realização de validações cadastrais diretamente na chamada. Essas validações podem ocorrer de forma isolada ou combinada, permitindo confirmar diferentes atributos do indivíduo sem custo adicional, e tornando o processo de checagem mais eficiente e integrado.

Estado civil

As informações de estado civil não estão concentradas em uma base cadastral pública única. Por isso, os dados disponíveis neste campo são construídos a partir das informações que a BigDataCorp consegue capturar e inferir ao longo do tempo. Isso significa que o estado civil retornado pode não refletir imediatamente uma mudança recente ou pode representar a informação mais atual identificada em nossas fontes. Por exemplo, um casamento ou uma separação pode ainda não estar refletida nos dados disponíveis.

Para interpretar esse campo corretamente, considere sempre a data da última atualização da informação retornada. Ela indica a referência temporal do dado e ajuda a avaliar sua adequação ao contexto da consulta.