Sócios e participações – Documentação

Recurso
Recurso	O que retorna	Créditos	Disponível
shareholders	Sócios: os sócios atuais com suas quotas e listas de sócios anteriores	5	qualquer conta · Beta
shareholders_deep	Sócios em profundidade: titulares com números das quotas, desde quando têm participação e o que mudou por último	80	Max
ubos	Beneficiários finais (UBO): as pessoas por trás da empresa, calculadas a partir das listas de sócios	10	qualquer conta · Beta
shareholdings	Participações: empresas nas quais a própria empresa tem participação	5	qualquer conta · Beta

Sócios por forma jurídica

O que o registro diz sobre os donos depende da forma jurídica. A tabela mostra o que você normalmente recebe.

Forma jurídica
Forma jurídica	Sócios na resposta
GmbH, UG	Todos os sócios da lista de sócios segundo o § 40 GmbHG, com valor nominal e participação no capital social (Stammkapital), mais listas anteriores.
AG, SE, KGaA	Só em casos isolados, porque os acionistas de uma AG não constam em nenhum registro público.
GmbH & Co. KG	Os sócios comanditários (Kommanditisten) do registro com seu valor de responsabilidade, em parte também a GmbH sócia de responsabilidade ilimitada.
KG, OHG	Os sócios registrados: numa KG os sócios de responsabilidade ilimitada (Komplementäre) e os comanditários, numa OHG os sócios com responsabilidade pessoal.
e.K.	O proprietário.
eG	Nenhum. A lista de membros de uma cooperativa não é pública.
PartG	Os sócios registrados.

Listas de sócios costumam ser documentos digitalizados em muitos layouts. Nós as extraímos automaticamente. Usamos a tecnologia mais recente para isso e investimos muito em qualidade; ainda assim, erros pontuais são possíveis.

Sócios

O recurso shareholders retorna os sócios atuais: numa GmbH, da lista de sócios mais recente; em sociedades de pessoas e empresários individuais, do registro. Custa 5 créditos, mas só quando indica sócios atuais. Se retornar só listas anteriores, não custa nada.

Cada entrada em entries descreve uma pessoa ou uma empresa. Uma pessoa tem first_name, last_name e birth_date; uma empresa, entity_name, country_code e registration_reference.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: SUA_CHAVE_DE_API" \
  --data-urlencode 'q=Hetzner Online GmbH' \
  --data-urlencode 'feature=shareholders'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "SUA_CHAVE_DE_API"},
    params={
        "q": "Hetzner Online GmbH",
        "feature": ["shareholders"],
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");
url.searchParams.append("feature", "shareholders");

const response = await fetch(url, {
  headers: { "x-api-key": "SUA_CHAVE_DE_API" },
});
const data = await response.json();

Campo
Campo	Significado	Exemplo	Disponibilidade
shareholdersobject\|null	Os sócios da empresa: estado atual em entries, estados anteriores em history.Vazio quando nenhum sócio é conhecido, por exemplo numa AG ou eG`shareholders` · Beta	–	geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA nunca: eG
shareholders.entriesarray	Os sócios atuais, uma entrada por pessoa ou empresa.	–	como acima
shareholders.entries[].shareholderobject	Quem detém a participação: uma pessoa ou uma empresa, com os campos abaixo.	–	como acima
shareholders.entries[].shareholder.entity_idstring\|null	ID da pessoa ou empresa, para o seu perfil de pessoa ou perfil da empresa.Vazio quando o sócio não pôde ser identificado com segurança	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	como acima
shareholders.entries[].shareholder.first_namestring	Prenome de uma pessoa, com todos os prenomes registrados.	–	sempre: e.K. geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG raramente: AG, SE, KGaA nunca: eG
shareholders.entries[].shareholder.last_namestring	Sobrenome de uma pessoa.	–	como acima
shareholders.entries[].shareholder.birth_datestring\|null	Data de nascimento de uma pessoa, no formato YYYY-MM-DD.Vazio quando o documento não informa data de nascimento	–	como acima
shareholders.entries[].shareholder.entity_namestring	Nome de uma empresa que é sócia.	`"ENSoXX GmbH"`	geralmente: GmbH, UG, GmbH & Co. KG raramente: AG, SE, KGaA, KG, OHG nunca: e.K., eG, PartG
shareholders.entries[].shareholder.country_codestring\|null	País de uma empresa como código ISO de três letras (ISO 3166-1 alpha-3), por exemplo DEU.	`"DEU"`	como acima
shareholders.entries[].shareholder.registration_referencestring\|null	Registro de uma empresa como texto, como aparece no documento.Vazio quando o documento não informa registro, muitas vezes em empresas estrangeiras	`"AG Ansbach HRB 6105"`	como acima
shareholders.entries[].shareholder.addressstring\|null	Endereço, local de residência ou sede como texto, como aparece no documento.Vazio quando o documento não informa endereço	`"Gunzenhausen"`	geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA nunca: eG
shareholders.entries[].contributionobject\|null	O valor da participação com amount e currency: numa GmbH, o valor nominal das quotas; para sócios comanditários, o valor de responsabilidade registrado (Haftsumme).Vazio quando nenhum valor está registrado, por exemplo para sócios com responsabilidade pessoal ou o proprietário de uma e.K	–	geralmente: GmbH, UG, GmbH & Co. KG em parte: KG, OHG raramente: AG, SE, KGaA nunca: e.K., eG, PartG
shareholders.entries[].contribution_rationumber\|null	Participação no capital como decimal: 1 significa 100 %, 0.245 significa 24,5 %.Vazio quando nenhuma participação pode ser derivada, por exemplo em sociedades de pessoas	`0.945`	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
shareholders.entries[].roleobject	A função: label como código fixo, mais de e en com um nome longo e um curto, por exemplo Kommanditist e Kom.	–	geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA nunca: eG
shareholders.entries[].role.labelstring	A função como código fixo. Novos valores podem ser acrescentados.Valores: `SHAREHOLDER` sócio segundo a lista de sócios, `LIMITED_PARTNER` sócio comanditário (Kommanditist), `FULLY_LIABLE_PARTNER` sócio com responsabilidade pessoal (persönlich haftender Gesellschafter), `PARTNER` sócio de uma PartG, `OWNER` proprietário de uma e.K.	`"SHAREHOLDER"`	como acima
shareholders.total_capitalobject\|null	O capital segundo a lista de sócios, com amount e currency, a base para contribution_ratio.Vazio quando a lista não informa capital, e em sociedades de pessoas	–	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG

Com o entity_id de um sócio, você obtém o perfil da empresa ou o perfil de pessoa dele. Assim você segue uma cadeia de propriedade nível por nível.

Histórico de sócios

shareholders.history vem sem custo adicional. Ele contém a data da lista atual e as listas de sócios anteriores, as mais recentes primeiro.

Numa KG ou GmbH & Co. KG, os antigos sócios estão em register_ownership, com datas de entrada e saída do registro. Para OHG, PartG e e.K., você os encontra em shareholders_deep.

Campo
Campo	Significado	Exemplo	Disponibilidade
shareholders.historyobject	Estados anteriores dos sócios, sem custo adicional.Vazio quando não existem estados anteriores; o campo então não aparece, por exemplo em OHG, PartG ou e.K`shareholders` · Beta	–	geralmente: GmbH, UG em parte: GmbH & Co. KG, KG, OHG raramente: AG, SE, KGaA nunca: e.K., eG, PartG
shareholders.history.current_as_ofstring\|null	Data da lista de sócios de onde vem entries.Vazio quando os sócios vêm do registro	`"2015-08-21"`	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
shareholders.history.pastarray	Listas de sócios anteriores, as mais recentes primeiro.Vazio quando só existe uma lista	–	como acima
shareholders.history.past[].as_ofstring	Data desta lista de sócios.	`"2015-07-28"`	como acima
shareholders.history.past[].data.total_capitalobject\|null	O capital segundo esta lista, com amount e currency. Listas mais antigas às vezes o informam em DEM.	–	como acima
shareholders.history.past[].data.shareholdersarray	Os sócios segundo esta lista, com os mesmos campos de entries.	–	como acima
shareholders.history.register_ownershipobject	Para KG e GmbH & Co. KG: antigos sócios segundo o registro, em past.	–	em parte: GmbH & Co. KG, KG, OHG nunca: GmbH, UG, AG, SE, KGaA, e.K., eG, PartG
shareholders.history.register_ownership.past[].shareholderobject	O antigo sócio, com os mesmos campos de entries.	–	como acima
shareholders.history.register_ownership.past[].roleobject	A função dele, estruturada como role em entries.	–	como acima
shareholders.history.register_ownership.past[].effective_fromstring\|null	Desde quando estava registrado, no formato YYYY-MM-DD.	`"2022-01-07"`	como acima
shareholders.history.register_ownership.past[].effective_tostring\|null	Até quando estava registrado.	`"2026-07-06"`	como acima
shareholders.history.register_ownership.past[].effective_to_inferredboolean	true se effective_to foi derivado e não registrado explicitamente.	`false`	como acima
shareholders.history.register_ownership.past[].contributionnull	Aqui sempre null.	–	como acima
shareholders.history.register_ownership.past[].contribution_rationull	Aqui sempre null.	–	como acima

Sócios em profundidade

O recurso shareholders_deep está incluído no plano Max. Custa 80 créditos, mas só quando o documento atual indica pelo menos um titular.

Ele lê todas as listas de sócios de uma empresa, não só a mais recente. Assim mostra desde quando alguém tem participação, como eram os estados anteriores e o que a última lista mudou.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: SUA_CHAVE_DE_API" \
  --data-urlencode 'q=Hetzner Online GmbH' \
  --data-urlencode 'feature=shareholders_deep'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "SUA_CHAVE_DE_API"},
    params={
        "q": "Hetzner Online GmbH",
        "feature": ["shareholders_deep"],
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");
url.searchParams.append("feature", "shareholders_deep");

const response = await fetch(url, {
  headers: { "x-api-key": "SUA_CHAVE_DE_API" },
});
const data = await response.json();

O documento. record diz de onde vem o estado atual, share_capital traz o capital segundo esse documento.

Campo
Campo	Significado	Exemplo	Disponibilidade
shareholders_deepobject\|null	Titulares, quotas, documentos anteriores e a última alteração.Vazio quando nenhum documento atual e nenhum sócio registrado é conhecido, típico de AG, SE e eG`shareholders_deep` · a partir de Max	–	geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA nunca: eG
shareholders_deep.recordobject	O documento de onde vem o estado atual: data e fonte.	–	como acima
shareholders_deep.record.datestring\|null	A data a que o documento se refere. Geralmente fica pouco depois da alteração que o documento mostra.Vazio quando os sócios vêm do registro (`COMMERCIAL_REGISTER`)	`"2015-08-18"`	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
shareholders_deep.record.sourcestring	O tipo de documento.Valores: `SHAREHOLDER_LIST` lista de sócios (Gesellschafterliste), `FOUNDING_DOCUMENT` documento de constituição, ou seja, Musterprotokoll (protocolo-modelo) ou Gesellschaftsvertrag (contrato social), `COMMERCIAL_REGISTER` sócios ou proprietários inscritos no registro	`"SHAREHOLDER_LIST"`	geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA nunca: eG
shareholders_deep.share_capitalobject\|null	O capital segundo o documento: value, currency e basis.Vazio quando o documento não informa capital, e sempre com COMMERCIAL_REGISTER	–	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
shareholders_deep.share_capital.basisstring	De onde vem o valor.Valores: `REPORTED` informado no documento, `CALCULATED` calculado a partir do número e do valor nominal das quotas	`"REPORTED"`	como acima

Os titulares. Cada entrada em entries é uma linha do documento, a maior participação primeiro. Se alguém tem várias linhas, aparece várias vezes na lista.

Campo
Campo	Significado	Exemplo	Disponibilidade
shareholders_deep.entriesarray	Os titulares atuais, uma linha do documento por entrada, a maior participação primeiro.`shareholders_deep` · a partir de Max	–	geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA nunca: eG
shareholders_deep.entries[].holderobject	Quem detém a participação. type determina quais campos seguem.	–	como acima
shareholders_deep.entries[].holder.typestring	O tipo de titular.Valores: `ORGANIZATION` empresa ou outra organização, `PERSON` pessoa física, `JOINT` quota detida em conjunto, por exemplo por uma comunhão de herdeiros, com members	`"ORGANIZATION"`	como acima
shareholders_deep.entries[].holder.entity_idstring\|null	ID do titular, para o seu perfil da empresa ou perfil de pessoa.Vazio quando o titular não pôde ser identificado com segurança, e sempre com JOINT	`"dd1cfcd3a25b5a63d549d768e2fcaaaf"`	como acima
shareholders_deep.entries[].holder.namestring	O nome. Para titulares identificados, o nome atual; caso contrário, como no documento.	`"ENSoXX GmbH"`	como acima
shareholders_deep.entries[].holder.birth_datestring\|null	Só para pessoas: a data de nascimento.Vazio quando o documento não a informa	–	sempre: e.K. geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, PartG raramente: AG, SE, KGaA nunca: eG
shareholders_deep.entries[].holder.legal_formstring\|null	Só para organizações: a forma jurídica como texto, por exemplo GmbH ou Ltd.	`"GmbH"`	geralmente: GmbH, UG, GmbH & Co. KG raramente: AG, SE, KGaA, KG, OHG nunca: e.K., eG, PartG
shareholders_deep.entries[].holder.statusstring\|null	Só para organizações: a situação atual no registro.Vazio quando o titular não foi identificado, e sempre nos documentos anteriores em historyValores: `ACTIVE` ativa, `INACTIVE` não mais ativa, por exemplo cancelada ou incorporada	`"ACTIVE"`	como acima
shareholders_deep.entries[].holder.citystring\|null	Sede ou local de residência.	`"Gunzenhausen"`	geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA nunca: eG
shareholders_deep.entries[].holder.countrystring\|null	País como código ISO de três letras (ISO 3166-1 alpha-3), por exemplo DEU, AUT ou LUX.	`"DEU"`	como acima
shareholders_deep.entries[].holder.registrationobject\|null	Só para organizações: court, register_type e register_number.Vazio quando nenhum registro pode ser lido, por exemplo em muitas empresas estrangeiras	–	geralmente: GmbH, UG, GmbH & Co. KG raramente: AG, SE, KGaA, KG, OHG nunca: e.K., eG, PartG
shareholders_deep.entries[].holder.registration_textstring\|null	Só para organizações: o registro como texto, quando registration falta ou não indica tribunal.	`null`	raramente
shareholders_deep.entries[].rolestring	A função do titular. Novos valores podem ser acrescentados.Valores: `SHAREHOLDER` sócio segundo a lista de sócios ou o documento de constituição, `LIMITED_PARTNER` sócio comanditário (Kommanditist), `FULLY_LIABLE_PARTNER` sócio com responsabilidade pessoal (persönlich haftender Gesellschafter), `PARTNER` sócio de uma PartG, `OWNER` proprietário de uma e.K.	`"SHAREHOLDER"`	geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA nunca: eG
shareholders_deep.entries[].sincestring\|null	Desde quando o titular tem participação. Para sócios registrados, a data do registro.Vazio quando nenhuma data pode ser determinada, e sempre com JOINT	`"2015-08-18"`	como acima
shareholders_deep.entries[].since_basisstring\|null	Quão certo é since.Valores: `ENTRY_RECORDED` documentado a partir desta data: a lista anterior ainda não indica o titular, `EARLIEST_RECORD` já no documento mais antigo disponível, ou seja, sócio desde pelo menos esta data	`"ENTRY_RECORDED"`	como acima

A participação. ownership descreve quanto um titular detém: em percentual, como valor nominal e pelos números sequenciais das quotas.

Campo
Campo	Significado	Exemplo	Disponibilidade
shareholders_deep.entries[].ownershipobject	A participação do titular.`shareholders_deep` · a partir de Max	–	geralmente: GmbH, UG, GmbH & Co. KG, KG, OHG, e.K., PartG raramente: AG, SE, KGaA nunca: eG
shareholders_deep.entries[].ownership.percentagenumber\|null	Participação no capital em percentual, de 0 a 100. É a participação direta, não os direitos de voto.Vazio quando a participação não pode ser determinada com confiança, e sempre para sócios registrados de sociedades de pessoas	`94.5`	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
shareholders_deep.entries[].ownership.percentage_basisstring\|null	De onde vem percentage.Valores: `REPORTED` informado no documento ou derivado do valor nominal e do capital no documento, `CALCULATED` calculado a partir do número e do valor nominal das quotas	`"REPORTED"`	como acima
shareholders_deep.entries[].ownership.nominal_amountobject\|null	Soma dos valores nominais com value e currency. Para sócios comanditários, o valor de responsabilidade registrado (Haftsumme).Vazio quando nenhum valor é conhecido	–	geralmente: GmbH, UG, GmbH & Co. KG em parte: KG, OHG raramente: AG, SE, KGaA nunca: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_countinteger\|null	Número de quotas (Geschäftsanteile).Vazio quando o número não é conhecido para todas as quotas	`47250`	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
shareholders_deep.entries[].ownership.share_rangesarray	As quotas pelos seus números sequenciais na lista, um intervalo por sequência de quotas iguais.	–	como acima
shareholders_deep.entries[].ownership.share_ranges[].frominteger\|null	Primeiro número sequencial do intervalo.	`1`	como acima
shareholders_deep.entries[].ownership.share_ranges[].tointeger\|null	Último número sequencial do intervalo.	`47250`	como acima
shareholders_deep.entries[].ownership.share_ranges[].countinteger\|null	Número de quotas no intervalo.	`47250`	como acima
shareholders_deep.entries[].ownership.share_ranges[].nominal_valueobject\|null	Valor nominal por quota no intervalo, com value e currency.	–	como acima

Histórico e alterações. history contém os documentos anteriores com os mesmos campos. Os titulares aparecem lá como constavam no documento da época. changes compara o estado atual com o anterior.

Campo
Campo	Significado	Exemplo	Disponibilidade
shareholders_deep.historyarray	Os documentos anteriores, os mais recentes primeiro, cada um com record, share_capital e entries. Antigos sócios registrados estão reunidos na última entrada.`shareholders_deep` · a partir de Max	–	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
shareholders_deep.history[].entries[].holder.membersarray	Para JOINT: os cotitulares do tipo PERSON ou ORGANIZATION, com os mesmos campos de holder.	–	raramente
shareholders_deep.history[].entries[].untilstring\|null	Só no item de history com COMMERCIAL_REGISTER: quando o sócio saiu.	–	em parte: GmbH & Co. KG, KG, OHG, PartG raramente: e.K. nunca: GmbH, UG, AG, SE, KGaA, eG
shareholders_deep.changesobject\|null	O que mudou com o documento atual em relação ao anterior.Vazio quando não há documento anterior, e quando o estado atual vem do registro ou de um documento de constituição	–	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
shareholders_deep.changes.compared_tostring\|null	Data do documento anterior.	`"2015-07-16"`	como acima
shareholders_deep.changes.joinedarray	Novos titulares: holder com entity_id, type e name, mais percentage.	–	como acima
shareholders_deep.changes.leftarray	Titulares que saíram, com a participação que tinham por último.	–	como acima
shareholders_deep.changes.changedarray	Titulares cuja participação mudou.	–	como acima
shareholders_deep.changes.changed[].percentage_beforenumber\|null	Participação em percentual no documento anterior.	`100`	como acima
shareholders_deep.changes.changed[].percentage_afternumber\|null	Participação em percentual no documento atual.	`5.5`	como acima

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "shareholders_deep": {5    "record": {6      "date": "2015-08-18",7      "source": "SHAREHOLDER_LIST"8    },9    "share_capital": {10      "value": 50000,11      "currency": "EUR",12      "basis": "REPORTED"13    },14    "entries": [15      {16        "holder": {17          "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",18          "type": "ORGANIZATION",19          "name": "ENSoXX GmbH",20          "legal_form": "GmbH",21          "status": "ACTIVE",22          "city": "Gunzenhausen",23          "country": "DEU",24          "registration": {25            "court": "Ansbach",26            "register_type": "HRB",27            "register_number": "6105"28          },29          "registration_text": null30        },31        "role": "SHAREHOLDER",32        "ownership": {33          "percentage": 94.5,34          "percentage_basis": "REPORTED",35          "nominal_amount": {36            "value": 47250,37            "currency": "EUR"38          },39          "share_count": 47250,40          "share_ranges": [41            {42              "from": 1,43              "to": 47250,44              "count": 47250,45              "nominal_value": {46                "value": 1,47                "currency": "EUR"48              }49            }50          ]51        },52        "since": "2015-08-18",53        "since_basis": "ENTRY_RECORDED"54      },55      {56        "holder": {57          "entity_id": "08ed5f967956831ca6588930fd2693ed",58          "type": "PERSON",59          "name": "Max Felix Mustermann",60          "birth_date": "1976-01-15",61          "city": "Musterheim",62          "country": "DEU"63        },64        "role": "SHAREHOLDER",65        "ownership": {66          "percentage": 5.5,67          "percentage_basis": "REPORTED",68          "nominal_amount": {69            "value": 2750,70            "currency": "EUR"71          },72          "share_count": 2750,73          "share_ranges": [74            {75              "from": 47251,76              "to": 50000,77              "count": 2750,78              "nominal_value": {79                "value": 1,80                "currency": "EUR"81              }82            }83          ]84        },85        "since": "2015-07-16",86        "since_basis": "EARLIEST_RECORD"87      }88    ],89    "history": [90      {91        "record": {92          "date": "2015-07-16",93          "source": "SHAREHOLDER_LIST"94        },95        "share_capital": {96          "value": 50000,97          "currency": "EUR",98          "basis": "REPORTED"99        },100        "entries": [101          {102            "holder": {103              "entity_id": "08ed5f967956831ca6588930fd2693ed",104              "type": "PERSON",105              "name": "Max Mustermann",106              "birth_date": "1976-01-15",107              "city": null,108              "country": null109            },110            "role": "SHAREHOLDER",111            "ownership": {112              "percentage": 100,113              "percentage_basis": "REPORTED",114              "nominal_amount": {115                "value": 50000,116                "currency": "EUR"117              },118              "share_count": 50000,119              "share_ranges": [120                {121                  "from": 1,122                  "to": 50000,123                  "count": 50000,124                  "nominal_value": {125                    "value": 1,126                    "currency": "EUR"127                  }128                }129              ]130            },131            "since": "2015-07-16",132            "since_basis": "EARLIEST_RECORD"133          }134        ]135      }136    ],137    "changes": {138      "compared_to": "2015-07-16",139      "joined": [140        {141          "holder": {142            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",143            "type": "ORGANIZATION",144            "name": "ENSoXX GmbH"145          },146          "percentage": 94.5147        }148      ],149      "left": [],150      "changed": [151        {152          "holder": {153            "entity_id": "08ed5f967956831ca6588930fd2693ed",154            "type": "PERSON",155            "name": "Max Felix Mustermann"156          },157          "percentage_before": 100,158          "percentage_after": 5.5159        }160      ]161    }162  }163}

200 · Resposta de exemplo: Hetzner Online GmbH com o recurso shareholders_deep

Em comparação com shareholders, shareholders_deep acrescenta os números das quotas, a data desde a qual alguém tem participação, as alterações e as quotas detidas em conjunto com seus membros. Para comparações entre empresas e anos, o melhor é usar o mesmo recurso o tempo todo.

Beneficiários finais

Beneficiários finais são as pessoas físicas que, em última instância, são donas de uma empresa. O recurso ubos segue as listas de sócios pelos níveis de propriedade até as pessoas. A lista indica cada pessoa com uma participação calculada, sem limite mínimo. Custa 10 créditos quando retorna dados.

Se uma participação não pode ser rastreada até uma pessoa, ela fica em unresolved_beneficial_owners com o motivo. Muitas vezes, quem a detém é uma empresa no exterior. Nossos dados cobrem empresas alemãs, então não conhecemos os sócios de uma empresa no exterior. coverage mostra que percentual do capital foi rastreado até pessoas e quanto fica em aberto. Os dois valores nem sempre somam 100. Para o restante, os dados de sócios não indicam titular.

O recurso é cobrado assim que retorna um resultado. Isso vale também quando todas as participações estão em unresolved_beneficial_owners.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: SUA_CHAVE_DE_API" \
  --data-urlencode 'q=Hetzner Online GmbH' \
  --data-urlencode 'feature=ubos'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "SUA_CHAVE_DE_API"},
    params={
        "q": "Hetzner Online GmbH",
        "feature": ["ubos"],
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");
url.searchParams.append("feature", "ubos");

const response = await fetch(url, {
  headers: { "x-api-key": "SUA_CHAVE_DE_API" },
});
const data = await response.json();

Campo
Campo	Significado	Exemplo	Disponibilidade
ubosobject\|null	Os beneficiários finais, calculados a partir das listas de sócios pelos níveis de propriedade.Vazio quando nenhuma cadeia pode ser montada a partir de listas de sócios, por exemplo em AG, eG ou e.K`ubos` · Beta	–	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
ubos.beneficial_ownersarray	As pessoas que são donas da empresa diretamente ou por meio de outras empresas.Vazio quando nenhuma participação pode ser rastreada até uma pessoa	–	como acima
ubos.beneficial_owners[].personobject	A pessoa, com os campos abaixo.	–	em parte: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
ubos.beneficial_owners[].person.entity_idstring\|null	ID da pessoa, para o perfil de pessoa.Vazio quando a pessoa não pôde ser identificada com segurança	–	como acima
ubos.beneficial_owners[].person.namestring	Nome completo.	–	como acima
ubos.beneficial_owners[].person.name_partsobject	O nome em partes: given e family, e canonical_name quando conhecido.	–	como acima
ubos.beneficial_owners[].person.birth_datestring\|null	Data de nascimento.	–	como acima
ubos.beneficial_owners[].person.locationobject\|null	Local de residência em home: city, county, state e country.Vazio quando nenhum local de residência é conhecido	–	como acima
ubos.beneficial_owners[].ownership_percentagenumber	Participação total da pessoa em percentual, somada por todos os caminhos.	`50`	como acima
ubos.beneficial_owners[].pathsarray	Cada caminho até a pessoa, com a participação ao longo desse caminho.	–	como acima
ubos.beneficial_owners[].paths[].percentagenumber	Participação em percentual que chega por este caminho.	`50`	como acima
ubos.beneficial_owners[].paths[].viaarray	As empresas neste caminho, primeiro o sócio direto da empresa consultada (depth 1). Os campos são os mesmos de via nas participações não resolvidas.Vazio quando a pessoa tem participação direta	–	como acima

Campo
Campo	Significado	Exemplo	Disponibilidade
ubos.unresolved_beneficial_ownersarray	Participações que não puderam ser rastreadas até uma pessoa.Vazio quando todas as participações estão resolvidas`ubos` · Beta	–	geralmente: GmbH, UG raramente: AG, SE, KGaA, GmbH & Co. KG, KG, OHG nunca: e.K., eG, PartG
ubos.unresolved_beneficial_owners[].reasonstring	Por que a cadeia termina aqui. Novos valores podem ser acrescentados.Valores: `unlinked` o sócio é uma empresa que não conseguimos associar a um registro alemão, geralmente uma empresa no exterior. Não conhecemos os sócios dela, então a cadeia termina aqui, `no_further_shareholder_data` o sócio é uma empresa alemã que conhecemos, mas não existe lista de sócios para ela, por exemplo uma KG, `cycle` a cadeia volta a uma empresa que já está nela, por exemplo quando uma empresa detém quotas próprias, `unknown` nada se sabe sobre o sócio, nem nome nem participação	`"cycle"`	como acima
ubos.unresolved_beneficial_owners[].namestring\|null	Nome do sócio onde a cadeia termina.Vazio quando o motivo é unknown	`"ENSoXX Holding AG"`	como acima
ubos.unresolved_beneficial_owners[].entity_idstring\|null	O ID dele, para o seu perfil da empresa.Vazio quando o sócio não está associado a uma empresa nos nossos dados, ou seja, nos motivos unlinked e unknown	`"58d67a0bb99b2bc5644cb8daba58e6a6"`	como acima
ubos.unresolved_beneficial_owners[].legal_formstring\|null	A forma jurídica dele.	`"AG"`	como acima
ubos.unresolved_beneficial_owners[].addressobject\|array	O endereço dele com street, house_number, postal_code, city, county, state, country e coordinates.Vazio quando nenhum endereço é conhecido; o valor é então uma lista vazia []	–	como acima
ubos.unresolved_beneficial_owners[].registrationobject\|array	O registro dele com court, register_type e register_number, também de registros estrangeiros.Vazio quando nenhum registro é conhecido; o valor é então uma lista vazia []	–	como acima
ubos.unresolved_beneficial_owners[].ownership_percentagenumber	A participação não resolvida em percentual, calculada até a empresa consultada. Pode ser 0.	`0`	como acima
ubos.unresolved_beneficial_owners[].viaarray	As empresas pelas quais a cadeia passa até aqui, primeiro o sócio direto da empresa consultada.Vazio quando a participação não resolvida é detida diretamente na empresa consultada	–	como acima
ubos.unresolved_beneficial_owners[].via[].depthinteger	O nível: 1 é um sócio direto da empresa consultada. Ao lado ficam o name e o entity_id da empresa.	`1`	como acima
ubos.unresolved_beneficial_owners[].via[].step_percentagenumber	Participação em percentual neste nível.	`94.5`	como acima
ubos.coverageobject	Quanto do capital foi rastreado até pessoas e quanto fica em aberto. Os dois valores nem sempre somam 100.	–	como acima
ubos.coverage.resolved_percentagenumber	Rastreado até pessoas, em percentual.	`5.5`	como acima
ubos.coverage.unresolved_percentagenumber	Não rastreado até pessoas, em percentual.	`0`	como acima

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "ubos": {5    "beneficial_owners": [6      {7        "person": {8          "entity_id": "08ed5f967956831ca6588930fd2693ed",9          "name": "Max Felix Mustermann",10          "birth_date": "1976-01-15",11          "name_parts": {12            "given": "Max Felix",13            "family": "Mustermann",14            "canonical_name": "Mustermann, Max Felix"15          },16          "location": {17            "home": {18              "city": "Musterheim",19              "county": "Musterheim (Landkreis)",20              "state": "Bayern",21              "country": "DEU"22            }23          }24        },25        "ownership_percentage": 5.5,26        "paths": [27          {28            "percentage": 5.5,29            "via": []30          }31        ]32      }33    ],34    "unresolved_beneficial_owners": [35      {36        "reason": "cycle",37        "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",38        "name": "ENSoXX Holding AG",39        "legal_form": "AG",40        "address": {41          "house_number": "25",42          "street": "Industriestraße",43          "postal_code": "91710",44          "city": "Gunzenhausen",45          "county": "Weißenburg-Gunzenhausen",46          "state": "Bayern",47          "country": "DEU",48          "coordinates": {49            "latitude": 49.12483,50            "longitude": 10.7805251          }52        },53        "registration": {54          "court": "Ansbach",55          "register_type": "HRB",56          "register_number": "6211"57        },58        "ownership_percentage": 0,59        "via": [60          {61            "depth": 1,62            "name": "ENSoXX GmbH",63            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",64            "step_percentage": 94.565          },66          {67            "depth": 2,68            "name": "ENSoXX Holding AG",69            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",70            "step_percentage": 10071          }72        ]73      },74      {75        "reason": "unknown",76        "entity_id": null,77        "name": null,78        "legal_form": null,79        "address": [],80        "registration": [],81        "ownership_percentage": 0,82        "via": [83          {84            "depth": 1,85            "name": "ENSoXX GmbH",86            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",87            "step_percentage": 94.588          },89          {90            "depth": 2,91            "name": "ENSoXX Holding AG",92            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",93            "step_percentage": 10094          }95        ]96      },97      {98        "reason": "unknown",99        "entity_id": null,100        "name": null,101        "legal_form": null,102        "address": [],103        "registration": [],104        "ownership_percentage": 0,105        "via": [106          {107            "depth": 1,108            "name": "ENSoXX GmbH",109            "entity_id": "dd1cfcd3a25b5a63d549d768e2fcaaaf",110            "step_percentage": 94.5111          },112          {113            "depth": 2,114            "name": "ENSoXX Holding AG",115            "entity_id": "58d67a0bb99b2bc5644cb8daba58e6a6",116            "step_percentage": 100117          }118        ]119      }120    ],121    "coverage": {122      "resolved_percentage": 5.5,123      "unresolved_percentage": 0124    }125  }126}

200 · Resposta de exemplo: Hetzner Online GmbH com o recurso ubos. Na nossa requisição de exemplo, uma pessoa estava em beneficial_owners com 5,5%. A cadeia pela ENSoXX GmbH, Ansbach HRB 6105, terminou em unresolved_beneficial_owners com os motivos cycle e unknown.

Calculamos os dados a partir das listas de sócios. Os dados sobre beneficiários finais do Transparenzregister (registro de transparência) não são acessíveis ao público desde o fim de 2022.

Participações

O recurso shareholdings mostra a outra direção: em quais empresas a empresa consultada tem participação. As participações vêm das listas de sócios dessas empresas. Custa 5 créditos quando há participações.

curl -G "https://handelsregister.ai/api/v1/fetch-organization" \
  -H "x-api-key: SUA_CHAVE_DE_API" \
  --data-urlencode 'q=Hetzner Online GmbH' \
  --data-urlencode 'feature=shareholdings'

import requests

response = requests.get(
    "https://handelsregister.ai/api/v1/fetch-organization",
    headers={"x-api-key": "SUA_CHAVE_DE_API"},
    params={
        "q": "Hetzner Online GmbH",
        "feature": ["shareholdings"],
    },
)
data = response.json()

const url = new URL("https://handelsregister.ai/api/v1/fetch-organization");
url.searchParams.append("q", "Hetzner Online GmbH");
url.searchParams.append("feature", "shareholdings");

const response = await fetch(url, {
  headers: { "x-api-key": "SUA_CHAVE_DE_API" },
});
const data = await response.json();

Campo
Campo	Significado	Exemplo	Disponibilidade
shareholdingsobject\|null	As empresas nas quais a empresa consultada tem participação.Vazio quando nenhuma participação é conhecida`shareholdings` · Beta	–	geralmente: AG, SE, KGaA em parte: GmbH, UG raramente: GmbH & Co. KG, KG, OHG, e.K., eG, PartG
shareholdings.holdings.currentarray	As participações atuais, uma por empresa.	–	como acima
shareholdings.holdings.current[].organizationobject	A empresa na qual as quotas são detidas.	–	como acima
shareholdings.holdings.current[].organization.entity_idstring	ID da empresa, para o seu perfil da empresa.	`"63529c3a793e9f002196b4fd344e1241"`	como acima
shareholdings.holdings.current[].organization.namestring\|null	Nome da empresa.	`"Hetzner Cloud GmbH"`	como acima
shareholdings.holdings.current[].organization.legal_formstring\|null	Forma jurídica da empresa.	`"GmbH"`	como acima
shareholdings.holdings.current[].organization.statusstring\|null	Situação da empresa no registro, por exemplo ACTIVE.	`"ACTIVE"`	como acima
shareholdings.holdings.current[].organization.addressobject\|array	Endereço da empresa, estruturado como address nos dados básicos.Vazio quando nenhum endereço é conhecido; o valor é então uma lista vazia []	–	como acima
shareholdings.holdings.current[].organization.registrationobject\|array	Registro da empresa com court, register_type e register_number.Vazio quando nenhum registro é conhecido; o valor é então uma lista vazia []	–	como acima
shareholdings.holdings.current[].ownership.percentagenumber\|null	Participação em percentual: 100 significa 100 %.Vazio quando a lista não permite derivar participação	`100`	como acima
shareholdings.holdings.current[].ownership.contributionobject	Valor nominal das quotas com amount e currency.	–	como acima
shareholdings.holdings.current[].as_ofstring	Data da lista de sócios de onde vem a participação.	`"2017-09-19"`	como acima
shareholdings.summary.total_currentinteger	Número de participações atuais.	`2`	como acima

1{2  "entity_id": "94eb910fef13f94585c48c263fa446d4",3  "name": "Hetzner Online GmbH",4  "shareholdings": {5    "holdings": {6      "current": [7        {8          "organization": {9            "entity_id": "63529c3a793e9f002196b4fd344e1241",10            "name": "Hetzner Cloud GmbH",11            "status": "ACTIVE",12            "legal_form": "GmbH",13            "address": {14              "house_number": "12A",15              "street": "Feringastraße",16              "postal_code": "85774",17              "city": "Unterföhring",18              "county": "München (Landkreis)",19              "state": "Bayern",20              "country": "DEU",21              "coordinates": {22                "latitude": 48.17815,23                "longitude": 11.6348724              }25            },26            "registration": {27              "court": "München",28              "register_type": "HRB",29              "register_number": "226782"30            }31          },32          "ownership": {33            "percentage": 100,34            "contribution": {35              "amount": 25000,36              "currency": "EUR"37            }38          },39          "as_of": "2017-09-19"40        },41        {42          "organization": {43            "entity_id": "997f1b8314b8b56573208ae2334abb1d",44            "name": "possum Projekt 1 GmbH",45            "status": "ACTIVE",46            "legal_form": "GmbH",47            "address": {48              "house_number": "169-173",49              "street": "Meisenburgstraße",50              "postal_code": "45133",51              "city": "Essen",52              "county": "Essen",53              "state": "Nordrhein-Westfalen",54              "country": "DEU",55              "coordinates": {56                "latitude": 51.40102,57                "longitude": 6.9580558              }59            },60            "registration": {61              "court": "Essen",62              "register_type": "HRB",63              "register_number": "35604"64            }65          },66          "ownership": {67            "percentage": 100,68            "contribution": {69              "amount": 25000,70              "currency": "EUR"71            }72          },73          "as_of": "2026-08-18"74        }75      ]76    },77    "summary": {78      "total_current": 279    }80  }81}

200 · Resposta de exemplo: Hetzner Online GmbH com o recurso shareholdings

As participações de uma pessoa estão no perfil de pessoa, com o mesmo recurso.

Estruturas de grupo

Você monta ligações de grupo a partir de vários dados. shareholders e shareholdings mostram as participações um nível acima e abaixo, ubos as pessoas no fim da cadeia.

A Rede da empresa liga empresas e pessoas em dois níveis. Ela também inclui empresas coligadas.

Fusões, cisões e outras transformações estão em Fusões e aquisições.