Relacionamentos

Descrição

O dataset de Relacionamentos retorna informações sobre outras entidades, sejam elas pessoas ou empresas, que estão relacionadas com a empresa consultada. Os tipos de relacionamentos cobertos vão desde relacionamentos societários até funcionários. O objeto de retorno deste dataset contém algumas informações agregadas e uma lista de relacionamentos, com o detalhamento de cada um deles.

Origem da Informação

As informações de quadro societário e representação legal são extraídas à partir de dados de empresas disponibilizados publicamente pela Receita Federal do Brasil (ou órgãos equivalentes em outros países). Outros tipos de relacionamento, como o de emprego, são inferidos à partir de informações contextuais, como a utilização de um e-mail do domínio corporativo da empresa, ou a apresentação de um telefone empresarial como referência.

Tabela de preços para esse dataset

Parâmetros de consulta

A tabela abaixo detalha os campos aceitos na consulta a este dataset.

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": "relationships",
    "q": "doc{CNPJ}"  
}  

Filtros

Abaixo está um exemplo de como utilizar o parâmetro .filter(nome_do_campo=XXXX)

{  
    "Datasets": "relationships.filter(relatedentitytaxidtype=cnpj)",
    "q": "doc{CNPJ}"  
}  

Limite

Para utilizar o campo de limite basta utilizar o parâmetro .limit(x)

{  
    "Datasets": "relationships.limit(10)",
    "q": "doc{CNPJ}"  
}  

Paginação

A paginação do dataset pode ser feita através do parâmetro .next(x), utilizando o ID retornado pela requisição anterior e um parâmetro de consulta q com o mesmo parâmetro inserido na consulta original, conforme o exemplo abaixo:

{  
    "Datasets": "relationships.next(Id da próxima página)",
    "q": "doc{CNPJ}"  
}  

Alguns dos campos deste dataset têm valores pré-definidos, seguindo a tabela abaixo: