> ## Documentation Index > Fetch the complete documentation index at: https://docs.otbstudio.ai/llms.txt > Use this file to discover all available pages before exploring further. # Eigendom ophalen > Wie een belang heeft in deze onderneming, en de belangen die zij in andere heeft. Beide richtingen hebben dezelfde vorm, en het ondernemingsnummer van elke andere partij kan direct terug in deze route, zodat u een keten kunt volgen. ## OpenAPI ````yaml /api-reference/openapi.nl.json get /v1/companies/{id}/ownership openapi: 3.0.3 info: title: OTB Studio API version: 1.0.0 description: >- Het Belgische ondernemingsregister via REST: zoeken, profielen, eigendom, neergelegde jaarrekeningen en mandaten. Elke route vraagt een `otb_live_`-token, en elk geleverd antwoord kost credits voor de datapunten die het bevat. servers: - url: https://api.otbstudio.ai security: - token: [] tags: - name: Companies description: Eén ondernemingsregister, op vijf manieren gelezen. paths: /v1/companies/{id}/ownership: get: tags: - Companies summary: Eigendom ophalen description: >- Wie een belang heeft in deze onderneming, en de belangen die zij in andere heeft. Beide richtingen hebben dezelfde vorm, en het ondernemingsnummer van elke andere partij kan direct terug in deze route, zodat u een keten kunt volgen. operationId: getCompanyOwnership parameters: - $ref: '#/components/parameters/id' responses: '200': description: Beide richtingen. Elke lijst kan leeg zijn. headers: X-Credits-Cost: $ref: '#/components/headers/X-Credits-Cost' X-Credits-Remaining: $ref: '#/components/headers/X-Credits-Remaining' content: application/json: schema: $ref: '#/components/schemas/Ownership' example: enterpriseNumber: BE0712345630 shareholders: - name: Noordkaap Holding NV enterpriseNumber: BE0723456781 stakePercent: 72.5 shareClass: Gewone aandelen asOf: '2025-03-31' sourceReference: 2025-00184417 sourceSystem: NBB exact: true participations: - name: Noordkaap Warehousing enterpriseNumber: BE0734567835 stakePercent: 100 asOf: '2025-03-31' sourceReference: 2025-00184417 sourceSystem: NBB exact: true '401': $ref: '#/components/responses/Unauthorized' '402': $ref: '#/components/responses/PaymentRequired' '404': $ref: '#/components/responses/NotFound' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/Internal' '503': $ref: '#/components/responses/Busy' components: parameters: id: name: id in: path required: true description: >- Het ondernemingsnummer. `0712.345.630`, `BE 0712 345 630` en `BE0712345630` worden allemaal aanvaard. schema: type: string example: BE0712345630 headers: X-Credits-Cost: description: Wat dit antwoord kostte, in credits. schema: type: integer X-Credits-Remaining: description: Het saldo na dit antwoord. schema: type: integer Retry-After: description: Seconden wachten voor een nieuwe poging. schema: type: integer schemas: Ownership: type: object additionalProperties: false required: - enterpriseNumber - shareholders - participations properties: enterpriseNumber: type: string shareholders: type: array description: Belangen in deze onderneming. items: $ref: '#/components/schemas/Stake' participations: type: array description: Belangen die deze onderneming in andere heeft. items: $ref: '#/components/schemas/Stake' Stake: type: object additionalProperties: false description: Eén eigendomsband, gelezen vanaf elke kant. required: - exact properties: name: type: string description: De andere partij. enterpriseNumber: type: string description: Het nummer van de andere partij. Niet altijd Belgisch. stakePercent: type: number description: Het rechtstreekse belang, 50 voor de helft. indirectPercent: type: number description: Een belang via een andere entiteit, op dezelfde schaal. shareClass: type: string description: >- De aandelencategorie zoals neergelegd, in de taal van de neerlegging. asOf: type: string format: date description: Het einde van het boekjaar dat de neerlegging dekt. sourceReference: type: string description: De neerlegging waaruit het belang is gelezen. sourceSystem: type: string description: >- `NBB` voor neerleggingen bij de Nationale Bank. Hun referenties kunnen worden opgezocht. exact: type: boolean description: >- Het eigen vertrouwen van de bron dat deze band precies is gestaafd. False wijst op een verouderde of afgeleide vermelding. Unauthorized: type: object additionalProperties: false required: - code properties: code: type: string enum: - missing_token - invalid_token PaymentRequired: type: object additionalProperties: false required: - code properties: code: type: string enum: - insufficient_credits NotFound: type: object additionalProperties: false required: - code properties: code: type: string enum: - not_found RateLimited: type: object additionalProperties: false required: - code properties: code: type: string enum: - rate_limited Internal: type: object additionalProperties: false required: - code properties: code: type: string enum: - internal Busy: type: object additionalProperties: false required: - code properties: code: type: string enum: - busy responses: Unauthorized: description: >- Geen token, of een ongeldig token. `missing_token` als er geen `Authorization: Bearer`-header is, `invalid_token` als het token onbekend, ingetrokken of van de verkeerde soort is. content: application/json: schema: $ref: '#/components/schemas/Unauthorized' PaymentRequired: description: >- De organisatie heeft geen abonnement, het saldo is leeg, of het saldo dekt dit antwoord niet. Als het antwoord te duur was, zeggen de headers wat het zou kosten en wat er overblijft. headers: X-Credits-Cost: $ref: '#/components/headers/X-Credits-Cost' X-Credits-Remaining: $ref: '#/components/headers/X-Credits-Remaining' content: application/json: schema: $ref: '#/components/schemas/PaymentRequired' NotFound: description: Geen onderneming heeft dit ondernemingsnummer. content: application/json: schema: $ref: '#/components/schemas/NotFound' RateLimited: description: >- De organisatie zit boven haar limiet (10 oproepen per seconde, pieken van 20) of heeft 4 oproepen lopen. Probeer opnieuw na `Retry-After`. headers: Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/RateLimited' Internal: description: Er ging iets mis aan onze kant. content: application/json: schema: $ref: '#/components/schemas/Internal' Busy: description: >- De gegevens konden niet binnen 15 seconden worden gelezen. Probeer opnieuw na `Retry-After`. headers: Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/Busy' securitySchemes: token: type: http scheme: bearer description: Een `otb_live_`-token, aangemaakt in het OTB Studio-dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.