Datasets

A API KYC oferece diversos datasets especializados que podem ser combinados conforme a necessidade da sua aplicação:

​

1. Dados Cadastrais Básicos (basic)

Informações cadastrais fundamentais da pessoa física:

• Nome completo e nome da mãe
• CPF e data de nascimento
• Situação cadastral
• Dados básicos de identificação

Quando usar: Validação de identidade, processos de cadastro, verificação de dados fornecidos.

​

2. Endereços (addresses)

Retorna informações detalhadas sobre endereços associados ao CPF:

• Logradouro, número, complemento
• Bairro, cidade, UF e CEP
• Frequência e quantidade de passagens do endereço
• Datas de primeira e última aparição
• Indicadores de confiabilidade do endereço

Quando usar: Validação de endereço, análise de estabilidade residencial, verificação de consistência cadastral.

​

3. Telefones (phones)

Fornece dados sobre telefones vinculados ao CPF:

• Número de telefone e tipo (fixo/celular)
• Frequência de observações nos registros
• Indicadores de uso e confiabilidade
• Histórico de primeira e última aparição

Quando usar: Validação de contato, análise de canais de comunicação, detecção de inconsistências.

​

4. E-mails (emails)

E-mails vinculados ao CPF com informações de validade:

• Endereços de e-mail associados
• Frequência de aparições
• Indicadores de validade e uso
• Histórico de observações

Quando usar: Validação de canal de comunicação digital, verificação de identidade online.

​

5. Dados Profissionais (occupations)

Histórico de empregos e atividades profissionais:

• Vínculos empregatícios formais
• Histórico de ocupações
• Atividades profissionais registradas
• Períodos de trabalho

Quando usar: Verificação de renda, análise de capacidade de pagamento, validação de informações profissionais.

​

6. Profissões (professions)

Informações sobre a atividade profissional declarada ou registrada da pessoa:

• Profissão declarada
• Categoria profissional
• Área de atuação
• Períodos e vínculos

Quando usar: Validação de perfil profissional, análise de consistência cadastral, avaliação socioeconômica.

​

7. Informações Financeiras (financial_data)

Indicadores financeiros e estimativas de patrimônio:

• Estimativas de renda
• Indicadores de patrimônio
• Capacidade financeira
• Poder de compra estimado

Quando usar: Análise de crédito, definição de limites, avaliação de capacidade de pagamento.

​

8. Processos Judiciais e Administrativos (processes)

Histórico completo de processos envolvendo a pessoa física:

• Identificação e numeração dos processos
• Partes envolvidas (autor, réu, outros)
• Natureza e assunto do processo
• Andamentos e movimentações processuais
• Órgão/tribunal de origem

Quando usar: Avaliação de riscos jurídicos, verificação de antecedentes, due diligence.

​

9. KYC e Compliance (kyc)

Informações regulatórias e de compliance:

• Pessoas Politicamente Expostas (PEP)
• Sanções e restrições nacionais e internacionais
• Listas de observância e alertas regulatórios
• Origem e detalhamento das restrições
• Histórico de sanções

Quando usar: Processos de KYC/compliance, prevenção à lavagem de dinheiro (PLD), análise de risco reputacional.

​

10. Relacionamentos Econômicos (business_relationships)

Relações com empresas e participações societárias:

• Vínculos empresariais
• Participações societárias
• Relacionamentos econômicos
• Empresas relacionadas

Quando usar: Análise de exposição a riscos, mapeamento de vínculos empresariais, due diligence.

​

11. Pessoas Relacionadas (related_people)

Mapeamento de vínculos entre a pessoa consultada e outras pessoas físicas ou jurídicas:

• Pessoas relacionadas
• Tipo de vínculo
• Relacionamentos familiares ou societários

Quando usar: Análise de rede de relacionamento, identificação de vínculos indiretos, investigações de risco.

​

12. Certidão PGFN (pgfn_certificate_person)

Consulta on-demand de débitos tributários federais:

• Status da certidão (POSITIVA/NEGATIVA)
• Dívida ativa da União
• Créditos tributários federais
• Datas de emissão e validade

Quando usar: Análise de compliance fiscal, verificação de regularidade tributária, processos de crédito.

​

13. Antecedentes Criminais Federais (federal_criminal_certificate_person)

Certidão de antecedentes criminais emitida pela Polícia Federal:

• Status de antecedentes
• Registros criminais federais
• Data de emissão
• Validade da certidão

Quando usar: Processos seletivos, contratações, verificação de background.

​

14. Distribuição de Processos Judiciais (lawsuits_distribution_data)

Informações sobre a distribuição de processos judiciais:

• Total de processos
• Distribuição por tipo e por status
• Tribunal de origem, classe processual

Quando usar: Due diligence jurídica, análise de histórico judicial, monitoramento de novos processos.

​

15. Questionário de Endividamento (indebtedness_question)

Informações sobre situação de endividamento:

• Indicador de inadimplência
• Evidências e fontes

Quando usar: Avaliação de crédito, análise financeira, concessão de crédito.

​

16. Cobranças (collections)

Registros de cobrança e recuperação de crédito:

• Indicação de presença em cobrança
• Total de ocorrências e origens

Quando usar: Avaliação de risco de crédito, análise de inadimplência.

​

17. Assistência Social (social_assistance)

Registros de participação em programas de assistência social:

• Programas sociais vinculados
• Benefícios recebidos
• Valores e histórico

Quando usar: Avaliação socioeconômica, validação de informações declaradas.

​

18. Assistência Social Familiar (family_social_assistance)

Benefícios de assistência social do núcleo familiar:

• Total de membros e beneficiários
• Programas e valores
• Lista de assistências

Quando usar: Avaliação socioeconômica familiar, validação de renda indireta.

​

19. Doações Eleitorais (electoral_donors)

Registros de doações para campanhas eleitorais:

• Valores doados
• Ano da eleição e cargo
• Total de doações

Quando usar: Identificação de exposição política, análise reputacional, due diligence.

​

20. Dados de Candidato Eleitoral (election_candidate_data)

Participação em eleições:

• Candidaturas
• Cargo, partido, ano
• Indicação de eleição

Quando usar: Identificação de exposição política, análise de risco reputacional, compliance.

​

21. Status Cadastral (status_person)

Situação cadastral da pessoa em registros oficiais:

• Certidões de situação na Receita Federal (PF)
• Origem, URL, status

Quando usar: Validação cadastral, onboarding, verificação de consistência.

​

22. Certidão Nada Consta (clearance_certificate_person)

Certidão de ausência de pendências em ações judiciais:

• Origem, protocolo
• URL do resultado, status

Quando usar: Verificação de regularidade administrativa, processos de contratação.

​

23. Certidão Trabalhista (labor_certificate_person)

Certidões de ações trabalhistas:

• Protocolo, URL do resultado
• Status

Quando usar: Due diligence trabalhista, verificação de pendências legais.

​

24. Certidão de Débitos Estaduais (state_debt_certificate_person)

Certidão de ausência de débito por estado:

• Origem, protocolo
• URL do resultado, status

Quando usar: Verificação de regularidade fiscal estadual, compliance.

​

25. Certidão de Débitos Trabalhistas (labor_debt_certificate_person)

Certidão de ausência de débito trabalhista:

• Origem, protocolo
• URL do resultado, status

Quando usar: Due diligence trabalhista, verificação de regularidade legal.

​

26. Certidão de Regularidade IBAMA (ibama_regularity_certificate_person)

Certidão de regularidade ambiental perante o IBAMA:

• Origem, protocolo
• URL do resultado, status

Quando usar: Due diligence ambiental, compliance regulatório.

​

27. Exposição e Perfil na Mídia (media_profile_and_exposure)

Análise de presença em notícias e mídia:

• Indicadores de volume de exposição
• Análise de sentimento (positivo/negativo/neutro)
• Lista de notícias e menções relevantes
• Fontes e datas das publicações

Quando usar: Análise de reputação, monitoramento de imagem, due diligence reputacional.

​

Retorno dos Dados

A resposta do endpoint GET retorna os dados no objeto result, com o array result.datasets. Cada item desse array contém:

• dataset: código do dataset (igual aos códigos usados na requisição: basic, addresses, kyc, etc.)
• data: objeto com os dados do dataset; a estrutura de data varia conforme o tipo de dataset