> ## 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 les personnes > Administrateurs et autres mandats déposés pour cette entreprise, les mandats en cours d'abord, puis l'historique. Le parti politique, la rémunération et l'adresse du domicile ne sont jamais renvoyés, et les personnes que la source marque comme masquées sont omises. ## OpenAPI ````yaml /api-reference/openapi.fr.json get /v1/companies/{id}/people 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}/people: get: tags: - Companies summary: Obtenir les personnes description: >- Administrateurs et autres mandats déposés pour cette entreprise, les mandats en cours d'abord, puis l'historique. Le parti politique, la rémunération et l'adresse du domicile ne sont jamais renvoyés, et les personnes que la source marque comme masquées sont omises. operationId: getCompanyPeople parameters: - $ref: '#/components/parameters/id' - name: limit in: query required: false description: >- Nombre de mandats renvoyés, de 1 à 200. Une valeur absente, nulle, négative ou plus grande donne 50. schema: type: integer default: 50 responses: '200': description: Les mandats. Une liste vide si aucun n'est déposé. 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/PeopleReply' example: people: - lastName: Verhaegen firstName: Lotte category: ADMINISTER role: '13' profession: Gedelegeerd bestuurder startDate: '2024-09-25' endDate: '2028-09-27' current: true viaCompany: Verhaegen Consult BV viaEnterpriseNumber: BE1023456797 sourceSystem: NBB sourceReference: 2025-00184417 - lastName: Peeters firstName: Luc category: OTHERMANDATE role: Aankoper current: true sourceSystem: BSDM '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: PeopleReply: type: object additionalProperties: false required: - people properties: people: type: array items: $ref: '#/components/schemas/Mandate' Mandate: type: object additionalProperties: false description: >- Une fonction qu'une personne exerce, ou a exercée, dans cette entreprise. required: - current properties: lastName: type: string firstName: type: string category: type: string description: >- `ADMINISTER`, `SHAREHOLDER`, `LOCALPOLITICALMANDATE` ou `OTHERMANDATE`. role: type: string description: >- Pour `ADMINISTER`, un code source sans libellé, par exemple `13`. Pour les autres catégories, la fonction en toutes lettres, dans la langue du dépôt. profession: type: string startDate: type: string format: date endDate: type: string format: date description: En général la fin du mandat, pas le jour où la personne est partie. current: type: boolean description: >- Si le mandat est en cours aujourd'hui. Lisez ce champ plutôt que les dates. viaCompany: type: string description: >- Rempli quand le mandat est exercé via une société, avec cette personne comme représentant permanent. viaEnterpriseNumber: type: string sourceSystem: type: string sourceReference: type: string 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.