Skip to content
Vai integrar a API REST da Zarv com ajuda de IA? Copie a instrução que aponta o modelo para esta documentação.
Ver a instrução
Você vai integrar a API REST da Zarv. Use a documentação oficial como fonte da verdade.

- Página desta integração: https://developers.zarv.com/api/id-v3/datasets/
- Autenticação Bearer JWT e hosts: https://developers.zarv.com/setup
- Índice das APIs: https://developers.zarv.com/api
- Índice da documentação em markdown: https://developers.zarv.com/llms.txt
- Documentação completa em um arquivo: https://developers.zarv.com/llms-full.txt

Os specs OpenAPI publicados são a fonte da verdade para rotas e schemas — use o spec da API que você escolher antes de escrever qualquer request.

Antes de escrever qualquer código, leia a página desta integração. Siga exatamente os nomes de campos, endpoints, callbacks e formatos que estiverem documentados — não invente parâmetros nem endpoints, e não deduza comportamento a partir de outras APIs que você conhece. Se algo de que você precisa não estiver na documentação, diga que não está em vez de supor.

Minha tarefa: [ex.: escolher a API certa e fazer a primeira chamada autenticada]

Datasets ​

Um enriquecimento devolve, em data, um objeto por módulo. Cada módulo é respondido por um dataset — uma versão publicada e imutável do módulo, como person-profile-2.0. Qual versão roda é definido pelo perfil (profileId); o campo modules.{módulo}.dataset da resposta diz qual respondeu.

Para saber qual dataset cada módulo do seu perfil usa antes de criar um enriquecimento, consulte GET /api/v3/profiles/{id}: o modules do perfil traz o mesmo dataset que a resposta do enriquecimento. GET /api/v3/profiles lista os perfis do seu workspace.

Uma versão publicada nunca muda de formato: uma mudança incompatível sai como uma nova versão, e o perfil escolhe quando migrar.

  • Base: roda sempre que o perfil inclui o módulo. O profile roda em todo enriquecimento: é ele que localiza o titular (outcome: subject_not_found quando não há titular).
  • Add-on: só roda quando pedido em options.modules na criação e habilitado no perfil.
EntidadeMóduloVersõesTipoDescrição (versão mais recente)
Pessoafinance1.0, 1.1BaseRenda estimada de um CPF convertida em reais, patrimonio, historico de declaracao de imposto de renda e beneficios sociais com extrato de pagamentos.
PessoafinanceAdvanced2.0Add-onRegistro negativo de credito de uma pessoa: dividas vencidas, protestos em cartorio, cheques devolvidos, acoes e execucoes judiciais e falencia, com a situacao do CPF na Receita Federal.
Pessoalawsuits1.0, 2.0BaseProcessos judiciais de um CPF classificados na taxonomia do CNJ, de duas fontes processuais: contadores por natureza, janelas de tempo, indicadores, e cada processo por inteiro.
Pessoaprofile1.0, 2.0BaseCadastro base de um CPF mais os contatos conhecidos: telefones, e-mails e enderecos com quantas fontes confirmam cada um, o canal preferencial, e os sinais de estrangeiro e de exposicao politica.
Pessoarelated1.0, 1.1, 2.0BaseRede de relacionamentos de um CPF com o parentesco lido de registro alem do inferido, e a natureza de cada linha declarada em basis.
Empresafinance1.0BasePorte e trajetoria de um CNPJ: faixa de faturamento, funcionarios hoje e nas medias de 1, 3 e 5 anos, filiais, socios, capital, indice de atividade e historico de cobranca.
EmpresafinanceAdvanced2.0Add-onRegistro negativo de credito de uma empresa: dividas vencidas, protestos em cartorio, cheques devolvidos e declaracao de contumacia, com a situacao cadastral do CNPJ.
Empresalawsuits1.0, 2.0BaseProcessos judiciais de um CNPJ classificados na taxonomia do CNJ, de duas fontes processuais: contadores por natureza, janelas de tempo, indicadores, e cada processo por inteiro.
EmpresaownersLawsuits1.0BaseProcessos judiciais dos sócios do quadro societário de um CNPJ, um histórico por pessoa: contadores por natureza, indicadores, e cada processo por inteiro.
Empresaprofile1.0BaseCadastro de um CNPJ na Receita Federal: existencia, nomes, situacao cadastral e seu motivo, natureza juridica, capital declarado, atividades e historico de mudancas.
Empresarelated1.0, 2.0BaseQuadro societario de um CNPJ mais o grupo por raiz do documento: matriz e filiais, com a distribuicao de situacao cadastral e de regime sobre o grupo inteiro.

Todo dataset tem o mesmo envelope:

json
{
  "dataset": "person-profile-2.0",
  "module": "profile",
  "profile": { "...": "os dados do módulo, sob o nome do módulo" },
  "rules": [{ "rule": "PROFILE_PERSON_DECEASED", "fired": false }]
}

rules traz os indicadores que o próprio dataset avalia sobre os dados (fired: true quando o indicador se aplica). Veja cada página para os campos e indicadores de cada versão.