> ## 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.

# Obtenir l'actionnariat

> Qui détient une participation dans cette entreprise, et les participations qu'elle détient dans d'autres. Les deux sens ont la même forme, et le numéro d'entreprise de chaque autre partie peut revenir directement dans cette route, pour suivre une chaîne.



## OpenAPI

````yaml /api-reference/openapi.fr.json get /v1/companies/{id}/ownership
openapi: 3.0.3
info:
  title: API OTB Studio
  version: 1.0.0
  description: >-
    Le registre belge des entreprises via REST : recherche, profils,
    actionnariat, comptes annuels déposés et mandats. Chaque route demande un
    jeton `otb_live_`, et chaque réponse livrée coûte des crédits pour les
    données qu'elle contient.
servers:
  - url: https://api.otbstudio.ai
security:
  - token: []
tags:
  - name: Companies
    description: Un registre des entreprises, lu de cinq façons.
paths:
  /v1/companies/{id}/ownership:
    get:
      tags:
        - Companies
      summary: Obtenir l'actionnariat
      description: >-
        Qui détient une participation dans cette entreprise, et les
        participations qu'elle détient dans d'autres. Les deux sens ont la même
        forme, et le numéro d'entreprise de chaque autre partie peut revenir
        directement dans cette route, pour suivre une chaîne.
      operationId: getCompanyOwnership
      parameters:
        - $ref: '#/components/parameters/id'
      responses:
        '200':
          description: Les deux sens. Chaque liste peut être vide.
          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: >-
        Le numéro d'entreprise. `0712.345.630`, `BE 0712 345 630` et
        `BE0712345630` sont tous acceptés.
      schema:
        type: string
      example: BE0712345630
  headers:
    X-Credits-Cost:
      description: Ce que cette réponse a coûté, en crédits.
      schema:
        type: integer
    X-Credits-Remaining:
      description: Le solde après cette réponse.
      schema:
        type: integer
    Retry-After:
      description: Secondes à attendre avant de réessayer.
      schema:
        type: integer
  schemas:
    Ownership:
      type: object
      additionalProperties: false
      required:
        - enterpriseNumber
        - shareholders
        - participations
      properties:
        enterpriseNumber:
          type: string
        shareholders:
          type: array
          description: Participations détenues dans cette entreprise.
          items:
            $ref: '#/components/schemas/Stake'
        participations:
          type: array
          description: Participations que cette entreprise détient dans d'autres.
          items:
            $ref: '#/components/schemas/Stake'
    Stake:
      type: object
      additionalProperties: false
      description: Un lien d'actionnariat, lu depuis l'un ou l'autre côté.
      required:
        - exact
      properties:
        name:
          type: string
          description: L'autre partie.
        enterpriseNumber:
          type: string
          description: Le numéro de l'autre partie. Pas toujours belge.
        stakePercent:
          type: number
          description: La participation directe, 50 pour la moitié.
        indirectPercent:
          type: number
          description: Une participation détenue via une autre entité, sur la même échelle.
        shareClass:
          type: string
          description: La catégorie d'actions telle que déposée, dans la langue du dépôt.
        asOf:
          type: string
          format: date
          description: La fin de l'exercice couvert par le dépôt.
        sourceReference:
          type: string
          description: Le dépôt dont la participation est tirée.
        sourceSystem:
          type: string
          description: >-
            `NBB` pour les dépôts à la Banque nationale. Leurs références
            peuvent être consultées.
        exact:
          type: boolean
          description: >-
            La confiance de la source dans la précision de ce lien. False
            signale une entrée périmée ou déduite.
    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: >-
        Aucun jeton, ou un jeton non valide. `missing_token` sans en-tête
        `Authorization: Bearer`, `invalid_token` si le jeton est inconnu,
        révoqué ou du mauvais type.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Unauthorized'
    PaymentRequired:
      description: >-
        L'organisation n'a pas d'abonnement, son solde est vide, ou le solde ne
        couvre pas cette réponse. Si la réponse était trop chère, les en-têtes
        disent ce qu'elle aurait coûté et ce qui reste.
      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: Aucune entreprise n'a ce numéro d'entreprise.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/NotFound'
    RateLimited:
      description: >-
        L'organisation dépasse sa limite (10 appels par seconde, pointes de 20)
        ou a 4 appels en cours. Réessayez après `Retry-After`.
      headers:
        Retry-After:
          $ref: '#/components/headers/Retry-After'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimited'
    Internal:
      description: Une erreur s'est produite de notre côté.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Internal'
    Busy:
      description: >-
        Les données n'ont pas pu être lues en 15 secondes. Réessayez après
        `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: Un jeton `otb_live_`, créé dans le tableau de bord OTB Studio.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.