Clique aqui para baixar a lista de datasets disponíveis, os seus parâmetros obrigatórios e opcionais e os respectivos campos de retorno.

Os Datasets de Pessoas Físicas consultam diversas fontes públicas para checar e validar dados cadastrais de clientes e fornecedores de maneira ágil e automatizada, realizando processos completos de análise de crédito, verificação de pendências financeiras, background check, due diligence e Know Your Customer (KYC), incluindo informações sobre pessoas politicamente expostas (PEPs), sanções e restrições em âmbito nacional e internacional.

De maneira geral, os datasets de pessoas físicas exigem o CPF como parâmetro obrigatório para consulta. No entanto, alguns datasets podem requerer parâmetros adicionais.

Os datasets se dividem em duas categorias, segundo a forma de coleta dos dados:
Datasets on-demand e Datasets de Atualização Regular.

🌐 Datasets on-demand

Os datasets on-demand coletam informações na fonte em tempo real, e, portanto, podem ser pontualmente impactados por instabilidades da fonte, alterações ou variações de captcha, flutuações de conectividade, entre outros fatores.

💡 Por isso, sugerimos o uso da rota assíncrona/webhook, associado a implementação de um mecanismo de retry para consultas malsucedidas.

As consultas malsucedidas não são cobradas.

Situação cadastral de CPF na Receita Federal

Descrição

Realiza, em tempo real, a consulta da situação cadastral do CPF na Receita Federal, retornando informações como CPF, nome, data de nascimento, situação cadastral, data de inscrição, dígito verificador, código de controle, além do comprovante em PDF e seu QR code de acesso.

Code: rf_situacao_cadastral_cpf_ondemand_817669

Parâmetros obrigatórios de entrada: cpf, data_nascimento.

Origem dos dados: Receita Federal do Brasil.

Dados retornados

url: URL em que a situação foi consultada

cpf: Número de documento (CPF)

nome: Nome completo

nome_social: Nome social

data_nascimento: Data de nascimento no formato "AAAA-MM-DD" (ISO 8601)

situacao: Situação cadastral

data_inscricao: Data da inscrição do CPF na Receita Federal

digito_verificador: Dígito verificador

data_hora_emissao: Data hora da emissão do comprovante da consulta de situação cadastral

codigo_autenticacao: Código de autenticação da consulta

observacao: Observação

qrcode: QRcode de acesso ao comprovante da consulta de situação cadastral

download: Comprovante da consulta de situação cadastral, convertido em formato base64

download_mimetype: Formato original do comprovante retornado no campo download

CENPROT - Consulta de protestos

Certidão Antecedentes Criminais - Polícia Federal

Descrição

Disponibiliza informações sobre a Certidão de Antecedentes Criminais da Polícia Federal do Brasil, possibilitando identificar se um indivíduo possui registros criminais no âmbito federal.

Caso não haja antecedentes, o retorno será indicado como "Nada Consta", porém, se houver registros, os detalhes não são exibidos nesta consulta.

🔹 Para obter as informações sobre processos criminais, recomendamos o uso do dataset Processos Judiciais e Administrativos.

Esse dataset se baseia exclusivamente nos dados fornecidos pela Polícia Federal.

🔹 Para informações sobre antecedentes criminais registrados em âmbito estadual, consulte o dataset Antecedentes Criminais - Polícia Civil, que retorna os registros conforme os dados de cada departamento estadual da Polícia Civil.

Code: ondemand_pf_antecedente_people_862909

Parâmetro obrigatório de entrada: cpf

Parâmetro opcional de entrada: birth_date (data de nascimento no padrão "AAAA-MM-DD"). O parâmetro birth_date é obrigatório para menores de idade, no entanto, por questões jurídicas, não são retornados dados de menores de 12 anos.

Dados retornados

matchKeys: Número do CPF consultado na fonte

onlineCertificates

Apresenta as informações da certidão.

origin: Fonte dos dados entregues

inputParameters: Parâmetros de entrada

protocolNumber: Número do protocolo

baseStatus: Status disponibilizado pela certidão simplificado

additionalOutputData

Lista de dados adicionais disponibilizado na certidão.

idNumber: Número do documento de identificação presente na certidão

status: Status disponibilizado pela certidão

certificateNumber: Número da certidão

certificateText: Texto retornado no certificado

emissionDate: Data de emissão do certidão

validity: Validade da certidão em dias

validUntil: Data do prazo final da validade da certidão

rawResultFile: Link do arquivo obtido na fonte

rawResultFileType: Formato do arquivo obtido na fonte

QueryDate: Data da consulta

Certidão Antecedentes Criminais - Polícia Civil

Descrição

Disponibiliza informações sobre a Certidão de Antecedentes Criminais da Polícia Civil, possibilitando identificar se um indivíduo possui registros criminais no estado consultado.

Caso não haja antecedentes, o retorno será indicado como "Nada Consta", porém, se houver registros, os detalhes não são exibidos nesta consulta.

🔹 Para obter informações detalhadas sobre processos criminais, recomendamos o uso do dataset Processos Judiciais e Administrativos.

⚠️ Atenção: Cada consulta a este dataset retorna o certificado de antecedentes criminais de um único estado, definido pelo cliente no parâmetro uf da requisição à API.

Os estados atualmente contemplados por esse dataset são: BA, CE, ES, MG, MS, MT, PA, PE, RJ, RR, RS, SE, SP.

Code: ondemand_pc_antecedente_by_state_people_862909

Parâmetros obrigatórios de entrada: cpf, uf, rg, e, de acordo com o estado consultado, confira os demais parâmetros obrigatórios na Tabela de Parâmetros por Estado abaixo.

Tabela de Parâmetros por Estado

Estado	`cpf`	`uf`	`rg`	`mothername`	`fathername`	`rgissuingagency`	`rgissuinguf`	`rgexpeditiondate`	`dateformat`	`placeofbirth`	`addresscore`	`addressnumber`	`neighborhood`
MG	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	-	-	-	-	-	-	-	-	-
CE	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	-	-	-	-	-	-	-	-	-
RR	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	-	-	-	-	-	-	-	-	-
MT	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OPCIONAL	OBRIGATÓRIO	OBRIGATÓRIO	-	-	OBRIGATÓRIO	-	-	-
RJ	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OPCIONAL	OBRIGATÓRIO	-	OBRIGATÓRIO	OBRIGATÓRIO	-	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO
PE	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	-	OBRIGATÓRIO	OBRIGATÓRIO	-	-	OBRIGATÓRIO	OBRIGATÓRIO	-	OBRIGATÓRIO
PA	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	-	-	OBRIGATÓRIO	-	-	OBRIGATÓRIO	-	-	-
MS	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	-	OBRIGATÓRIO	OBRIGATÓRIO	-	-	-	-	-	-
SE	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OPCIONAL	-	-	-	-	-	-	-	-
BA	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OPCIONAL	-	-	-	-	-	-	-	-
SP	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OPCIONAL	-	-	OBRIGATÓRIO	OBRIGATÓRIO	-	-	-	-
ES	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	OPCIONAL	-	OBRIGATÓRIO	-	-	-	-	-	-
RS	OBRIGATÓRIO	OBRIGATÓRIO	OBRIGATÓRIO	-	-	-	-	-	-	-	-	-	-

Descrição dos Parâmetros de Entrada

cpf: CPF

uf: Unidade Federativa. Valores possíveis: BA, CE, ES, MG, MS, MT, PA, PE, RJ, RR, RS, SE, SP

rg: Número da Carteira de Identidade/Registro Geral

mothername: Nome da mãe

fathername: Nome do pai

rgissuingagency: Órgão emissor do RG

rgissuinguf: Unidade Federativa da órgão emissor do RG

rgexpeditiondate: Data de emissão do RG

dateformat: Formato da data de emissão informada. Exemplo: AAAA-MM-DD

placeofbirth: Local de nascimento

addresscore: Endereço

addressnumber: Número do endereço

neighborhood: Bairro

city: Cidade

zipcode: CEP

Dados retornados

matchKeys: Número do CPF consultado na fonte

onlineCertificates

Apresenta as informações da certidão.

origin: Fonte dos dados entregues

inputParameters: Parâmetros de entrada

baseStatus: Status geral retornado pela fonte dos dados

additionalOutputData

idNumber: Número de identificação presente na certidão

status: Status retornado pela certidão

certificateNumber: Número da certidão

queriedUF: Sigla do estado consultado para emissão da certidão

certificateText: Texto retornado na certidão

emissionDate: Data de emissão do certidão

rawResultFile: Link do arquivo obtido na fonte

rawResultFileType: Formato do arquivo obtido na fonte

queryDate: Data de realização da consulta

Certidão Negativa de Débitos Trabalhistas

Sanções Administrativas do Banco Central

Qualificação Cadastral no E-Social

🗂️ Datasets de Atualização Regular

Os dados dos datasets de atualização regular não são coletados em tempo real. Em vez disso, são previamente obtidos e atualizados em intervalos periódicos, o que assegura maior eficiência no tempo de resposta.

O prazo de atualização varia conforme o dataset.

💫 GOLD - Análise de Crédito

Os datasets de atualização regular GOLD fornecem informações vitais para análises de risco robustas, aumentando a eficiência na avaliação de crédito e reduzindo significativamente o risco de inadimplência. Isso garante maior segurança nas transações e minimiza possíveis prejuízos financeiros.

Os dados incluem informações sobre:

Dados cadastrais e de contato

Débitos financeiras e ações judiciais

Scores

Indicadores de risco

As informações dos datasets GOLD são oriundos da Receita Federal e do Cadastro Positivo.

O Cadastro Positivo é um banco de dados que reúne o histórico de pagamento de consumidores e empresas, abrangendo empréstimos, cheque especial, cartões de crédito, consórcios, financiamentos e contas recorrentes. Funciona como um currículo financeiro usado na análise de crédito e é essencial para definir o score de crédito.

Resumo da consulta PF Gold através do Portal Most - mostID

Segmento

Indicador (field segment) numérico que indica:

Com atraso no positivo e com negativo ativo ou baixado

Com atraso no positivo e sem negativo ou baixado

Sem atraso no positivo e com negativo ativo ou baixado

Sem atraso no positivo e sem negativo ativo ou baixado

Sem positivo e com negativo ativo ou baixado

Sem informações

Score de crédito

O score de crédito (field score) é uma pontuação que varia de 300 a 1000. Quanto maior o score, menor a chance de inadimplência.

Ele é baseada nos dados positivos nos termos da Lei 12.414/11, dados negativos e dados cadastrais e facilita a análise ao classificar a pontuação em faixas alta, média e baixa de risco de inadimplência, e reflete a probabilidade de um consumidor honrar seus pagamentos.

Faixas de referência para o Score de Crédito:

🔴 400 a 600: Alto risco de inadimplência.

🔶 601 a 700: Médio risco de inadimplência.

🔷 701 a 1000: Baixo risco de inadimplência.

Score de compromisso de pagamento

Score de compromisso de pagamento (field PaymentCommitmentScore) que indica o percentual de probabilidade de um cliente honrar com seus compromissos financeiros em dia.

Score de capacidade de pagamento

Score de capacidade de pagamento (field ProfileScore) que indica o percentual de probabilidade de um cliente honrar com seus compromissos financeiros com base na sua capacidade de pagamento.

PF GOLD - CONSULTA COMPLETA

Descrição

Este dataset reúne informações cadastrais, indicadores de risco de crédito, score de crédito, ações judiciais, participações em empresas e registros no CCF.

Ele é uma combinação dos dados retornados pelos seguintes datasets:

PF GOLD - Best Info Cadastral

PF GOLD - Indicadores de Pendências

PF GOLD - Detalhamento de Pendências

PF GOLD - Score

Code: pf_gold_report_pf_488029

Periodicidade de atualização: Até dois meses.

Parâmetro(s) de entrada: cpf

Origem dos dados: Receita Federal e do Cadastro Positivo.

Dados retornados: Confira os campos retornados descritos nos quatro datasets GOLD listados na descrição acima.

PF GOLD - BEST INFO CADASTRAL

PF GOLD - INDICADORES DE PENDÊNCIAS

PF GOLD - DETALHAMENTO DE PENDÊNCIAS

PF GOLD - SCORE

Dados Cadastrais Básicos

Descrição

Fornece os principais dados de um indivíduo requisitados em processos de cadastro, incluindo nome, CPF, sexo, data de nascimento, nome da mãe, idade, situação fiscal, região fiscal, status de óbito e data da última atualização.

Code: basic_data_people_862909

Origem dos dados: Receita Federal, CNIS (Cadastro Nacional de Informações Sociais), processos judiciais, entidades de classe.

Periodicidade de atualização: A cada 3 meses para CPFs com status "REGULAR". CPFs com status críticos como "SUSPEITO" ou de pessoas acima de 65 anos são atualizados semanalmente.

Parâmetro de entrada obrigatório: cpf

Parâmetro de entrada opcional: birth_date (data de nascimento no padrão "AAAA-MM-DD"). O parâmetro birth_date é obrigatório para menores de idade, no entanto, por questões jurídicas, não são retornados dados de menores de 12 anos.

Dados retornados

taxidnumber: Número de identificação fiscal

taxidcountry: País de identificação do contribuinte

taxidfiscalregion: Região ao qual o número de identificação se refere. Valores possíveis: "DF-GO-MS-MT-TO", "AC-AM-AP-PA-RO-RR", "CE-MA-PI", "AL-PB-PE-RN", "BA-SE", "MG", "ES-RJ", "SP", "PR-SC", "RS"

alternativeidnumbers

Dicionário (chave - valor) com objetos que contém os números de identificação alternativos, quando disponíveis.

voterid: Número do título de eleitor

socialsecuritynumber: Número do PIS/NIT

rg: Número do RG (Registro Geral de Identificação ou Carteira de Identidade) seguindo o formato {XX} - {N}, onde "N" representa o número do documento e "XX" corresponde ao estado emissor. Um indivíduo pode possuir mais de um RG, seja emitido por diferentes estados ou pelo mesmo estado em momentos distintos.

cnh: Número da CNH (Carteira Nacional de Habilitação)

extendeddocumentinformation

Dicionário (chave - valor) com objetos que contém informações adicionais sobre os diferentes documentos de identificação.

documentnumber: Número do documento encontrado

documentlast4digits: Últimos quatro dígitos do documento (geralmente RG)

documentissuingagency: Nome do órgão ou agência que emitiu o documento

documentissuingstatecode: Sigla da UF da emissão do documento

creationdate: Data de criação (primeira captura) do registro do documento

lastupdatedate: Data de última atualização das informações do documento

sources: Lista de strings com as fontes de onde a informação do documento foi capturada

name: Nome da pessoa

aliases

Aliases é um dicionário de chaves e valores com diferentes pseudônimos para a pessoa consultada. As chaves mais comuns estão descritas abaixo

commonname: Nome comum

standardizedname: Nome com caracteres padronizados

socialname: Nome social

gender: Gênero da pessoa M, F, U

namewordcount: Quantidade de "tokens" (palavras) no nome da pessoa

inputbirthdatematch: Caso seja fornecida uma data de nascimento na entrada, contém um flag indicando se a data informada bate com a data encontrada para o CPF

nameuniquenessscore: Varia de 0 até 1, descrevendo o quão único é o nome completo da pessoa em comparação a outras

numberoffullnamenamesakes: Quantidade de homônimos (pessoas com o mesmo nome) que esse indivíduo

firstnameuniquenessscore: Varia de 0 até 1, descrevendo o quão único é o primeiro nome da pessoa em comparação a outras

firstandlastnameuniquenessscore: Varia de 0 até 1, descrevendo o quão único é o primeiro e último nome da pessoa em comparação a outras

birthdate: Data de nascimento da pessoa

age: Idade da pessoa

zodiacsign: Signo do zodíaco da pessoa

chinesesign: Signo chinês da pessoa

birthcountry: País em que a pessoa nasceu

birthstate: Estado em que a pessoa nasceu

mothername: Nome da mãe da pessoa

fathername: Nome do pai da pessoa

taxidstatus: Status da identificação fiscal, Valores possíveis: BIRTH DATE AND DOCUMENT DOESN'T MATCH, CANCELADA, CPF COM DADOS INCOMPLETOS, CPF DOES NOT EXIST IN RECEITA FEDERAL DATABASE, INVALID DOCUMENT, NULA, PENDENTE DE REGULARIZACAO, REGULAR, SUSPENSA, TITULAR FALECIDO

taxidorigin: Origem da identificação fiscal

hasobitindication: Indica se a pessoa já faleceu

obitindicationorigin: Origem da indicação de óbito

obitindicationyear: Ano da indicação de óbito

taxidstatusdate: Data de atualização do status na Receita Federal

maritalstatusdata

Dados do Estado Civil do indivíduo

maritalstatus: Estado Civil (CASADO, DIVORCIADO, ETC.)

maritalstatussource: Fonte da informação de Estado Civil

maritalstatuslastupdatedate: Data de atualização do Estado Civil

creationdate: Data de criação

lastupdatedate: Data da última atualização

Relacionamentos Pessoais

Processos Judiciais e Administrativos

KYC e Compliance

Endereços - Estendido

Descrição
Retorna os endereços associados à pessoa consultada, e informações adicionais sobre características do próprio endereço.

Code: addresses_extended_people_862909

Origem dos dados: Os dados de endereço são obtidos por inferência, a partir de capturas em páginas públicas, como marketplaces, fóruns, processos judiciais, entre outros, que contenham informações de endereço passíveis de extração.

Parâmetro de entrada obrigatório: cpf

Dados retornados

extendedAddresses

totalAddresses: Quantidade total de endereços encontrados para a entidade

totalWorkAddresses: Quantidade total de endereços de trabalho encontrados para a entidade

totalPersonalAddresses: Quantidade total de endereços pessoais encontrados para a entidade

totalUniqueAddresses: Quantidade total de endereços encontrados que estão associados apenas com essa entidade

totalAddressPassages: Quantidade total de passagens dessa entidade com algum endereço

totalBadAddressPassages: Quantidade total de passagens suspeitas dessa entidade com algum endereço

oldestAddressPassageDate: Data da primeira passagem dessa entidade com algum endereço

newestAddresspassageDate: Data da última passagem dessa entidade com algum endereço

addresses

Lista de objetos com informações detalhadas de cada um dos endereços encontrados.

typology: Tipo do Logradouro (Rua, Avenida, etc.)

title: Titularidade do endereço (i.e Praça, Nossa Senhora, Barão)

addressMain: Núcleo do endereço

number: Número de porta do endereço

complement: Complemento

neighborhood: Bairro

city: Cidade

state: Estado

country: País

zipcode: CEP

type: Tipo de Endereço (HOME, WORK ou OFFICIAL REGISTRATION)

complementType: Tipo de Endereço, inferido a partir do complemento (APARTMENT, HOUSE, STORE, COMMERCIAL OFFICE)

householdCode: Código de household do endereço

buildingCode: Código de building do endereço

addressEntityTotalPassages: Total de passagens do endereço com essa entidade

addressEntityBadPassages: Total de passagens avaliadas como "ruins" com essa entidade

addressEntityCrawlingPassages: Total de passagens referentes a capturas feitas na internet com essa entidade

addressEntityValidationPassages: Total de passagens incluindo algum tipo de validação com essa entidade

addressentityquerypassages: Total de passagens referente a alguma consulta com essa entidade

addressentitymonthaveragepassages: Média mensal de passagens do endereço com essa entidade

addressGlobalTotalPassages: Total de passagens do endereço

addressGlobalBadPassages: Total de passagens avaliadas como "ruins"

addressGlobalCrawlingPassages: Total de passagens referentes a capturas feitas na internet

addressGlobalValidationPassages: Total de passagens incluindo algum tipo de validação

addressGlobalQueryPassages: Total de passagens referente a alguma consulta

addressGlobalMonthAveragePassages: Média mensal de passagens do endereço

addressNumberOfEntities: Número de entidades relacionadas a esse endereço

priority: Indica a prioridade do endereço

isMainForEntity: Indica se o endereço é o principal para essa entidade

isRecentForEntity: Indica se o endereço é recente para essa entidade

isMainForOtherEntity: Indica se o endereço é o principal para outra entidade

isRecentForOtherEntity: Indica se o endereço é recente para outra entidade

isActive: Indica se está ativo

isRatified: Indica se o endereço foi ratificado junto a base de referência dos correios (DNE ou similar)

entityFirstPassageDate: Data da primeira passagem do endereço com essa entidade

entityLastPassageDate: Data de última passagem do endereço com essa entidade

globalFirstPassageDate: Data da primeira passagem do endereço

globalLastPassageDate: Data de última passagem do endereço

latitude: Latitude

longitude: Longitude

creationDate: Data de criação

lastUpdateDate: Data da última atualização

Dados Profissionais

Descrição
O conjunto de dados de Dados Profissionais fornece informações consolidadas sobre a trajetória de trabalho e o emprego atual de uma pessoa, juntamente com um registro detalhado de suas experiências profissionais anteriores. Ele abrange tanto empregos formais quanto trabalhos informais, como freelancers e profissionais autônomos.

Code: occupation_data_people_862909

Origem dos dados: RAIS e inferências em sites públicos que fornecem dados de profissionais autônomos e informações de emprego.

Periodicidade de atualização: Varia conforme a fonte, sendo que algumas atualizações são mensais, trimestrais ou anuais. Atualmente a RAIS só retorna informações relativas a administração pública, para os demais setores, para essa fonte, são informados os dados do ano-base 2022 (capturados em 2023).

Parâmetro de entrada obrigatório: cpf

Dados retornados

totalProfessions: Número total de profissões exercidas ou em exercício

totalActiveProfessions: Número total de profissões em exercício

totalIncome: Total de renda

isEmployed: Indica se a pessoa está empregada ou não

professionData

Lista de objetos dos trabalhos encontrados.

professions

Lista de objetos com os detalhes de cada trabalho encontrado.

sector: Setor da empresa Valores possíveis: PRIVATE, PUBLIC, etc.

country: País em que a profissão é exercida

companyIdNumber: CNPJ da empresa

companyName: Nome da empresa

area: Área da empresa onde a pessoa trabalha

level: Cargo ou posição (quando disponível)

status: Situação empregatícia. Valores possíveis: ACTIVE / INACTIVE

incomeRange: Faixa salarial estimada para o emprego

income: Renda estimada proporcionada por o emprego

discount: Valor do desconto relativo aos salários da profissão

rating: Rating da pessoa no site (quando disponível)

declaredSkills: Lista de habilidades declaradas pela pessoa

declaredInterests: Lista de interesses declarados pela pessoa

startDate: Data de início ou admissão no trabalho

endDate: Data de término ou desligamento do trabalho

creationDate: Data de criação

lastUpdateDate: Data da última atualização

Datasets de Pessoas Físicas

🌐 Datasets on-demand#

🗂️ Datasets de Atualização Regular#

💫 GOLD - Análise de Crédito#

🌐 Datasets on-demand

🗂️ Datasets de Atualização Regular

💫 GOLD - Análise de Crédito