> ## 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 une entreprise > Le profil d'une entreprise : dénominations, statut, forme juridique, adresse, coordonnées, activités, les derniers chiffres déposés, et des indicateurs qui disent quelles autres données existent pour elle. ## OpenAPI ````yaml /api-reference/openapi.fr.json get /v1/companies/{id} 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}: get: tags: - Companies summary: Obtenir une entreprise description: >- Le profil d'une entreprise : dénominations, statut, forme juridique, adresse, coordonnées, activités, les derniers chiffres déposés, et des indicateurs qui disent quelles autres données existent pour elle. operationId: getCompany parameters: - $ref: '#/components/parameters/id' responses: '200': description: Le profil. 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/Profile' example: enterpriseNumber: BE0712345630 nameNl: Noordkaap Logistics statusCode: AC juridicalFormCode: '014' juridicalSituationCode: '000' typeOfEnterpriseCode: '2' deleted: false startDate: '1998-06-15' street: Kaaiweg 14 zipCode: '9000' city: Gent website: noordkaap.example activities: 'MAIN :: 006 :: 2025 :: 49410;MAIN :: 001 :: 2025 :: 52100' financials: closingDate: '2025-03-31' reference: 2025-00184417 schemaType: full employees: 186.4 equity: 12480310.52 operatingIncome: 3912774.18 ebitda: 5240118.66 resultForPeriod: 2731905.07 healthIndicator: 10 has: annualAccounts: true participations: true accountants: true valuations: false socialBalances: true snapshotDate: '2026-04-29' '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: Profile: type: object additionalProperties: false required: - enterpriseNumber - deleted - has properties: enterpriseNumber: type: string nameNl: type: string description: La dénomination néerlandaise. nameFr: type: string description: La dénomination française. abbreviationNl: type: string commercialName: type: string statusCode: type: string description: Code BCE brut, sans libellé. juridicalFormCode: type: string description: Code BCE brut de la forme juridique, sans libellé. juridicalSituationCode: type: string description: Code BCE brut, sans libellé. typeOfEnterpriseCode: type: string description: Code BCE brut, sans libellé. deleted: type: boolean description: L'entreprise n'existe plus. Renvoyée plutôt que cachée. startDate: type: string format: date endDate: type: string format: date street: type: string zipCode: type: string city: type: string telephone: type: string email: type: string website: type: string activities: type: string description: >- Une chaîne composée : `MAIN :: 006 :: 2025 :: 58120`, répétée et séparée par `;`. La dernière partie est le code NACE et la troisième est une année. Les deux premières parties sont des codes source sans signification publiée. financials: $ref: '#/components/schemas/Period' has: $ref: '#/components/schemas/Available' snapshotDate: type: string format: date description: >- Date de la dernière mise à jour de cette entreprise depuis la source. Chaque réponse vaut à une date. Period: type: object additionalProperties: false description: Un exercice, tel que déposé. Les montants sont en euros. required: - closingDate properties: closingDate: type: string format: date reference: type: string description: >- La référence du dépôt à la Banque nationale de Belgique, pour vérifier un chiffre dans le document source. schemaType: type: string description: >- Le schéma du dépôt, par exemple `full` ou `abbreviated`. Une entreprise qui change de schéma rapporte un autre niveau de détail. corrected: type: boolean description: >- Ce dépôt a remplacé un dépôt antérieur pour le même exercice. C'est le chiffre qui fait foi. comparative: type: boolean description: >- Ces chiffres viennent de la colonne de l'exercice précédent d'un dépôt ultérieur, pas d'un dépôt propre. La référence ne peut pas être consultée. employees: type: number description: >- Moyenne des équivalents temps plein sur l'exercice, pas le nombre de personnes. equity: type: number operatingIncome: type: number ebitda: type: number description: >- Le chiffre dérivé de la source. Les comptes annuels belges n'ont pas de poste EBITDA. resultForPeriod: type: number healthIndicator: type: number description: >- Le score de la source, un nombre entier de 1 à 10. La méthode n'est pas publiée. cashFlow: $ref: '#/components/schemas/CashFlow' balanceSheet: $ref: '#/components/schemas/BalanceSheet' Available: type: object additionalProperties: false description: >- Quelles autres données la source détient pour cette entreprise. Une borne supérieure : un indicateur à true signifie que la source a ces données, pas qu'un appel renverra des lignes. required: - annualAccounts - participations - accountants - valuations - socialBalances properties: annualAccounts: type: boolean description: Lisible via la route des comptes annuels. participations: type: boolean description: Lisible via la route de l'actionnariat. accountants: type: boolean description: Déposé, pas encore servi par cette API. valuations: type: boolean description: Déposé, pas encore servi par cette API. socialBalances: type: boolean description: Déposé, pas encore servi par cette API. 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 CashFlow: type: object additionalProperties: false description: Le tableau des flux de trésorerie déposé. Seulement avec `detail=true`. properties: operating: type: number investing: type: number financing: type: number free: type: number cashAtPeriodEnd: type: number distributionsToOwners: type: number description: >- Dividendes et autres distributions aux propriétaires, tels que déposés. BalanceSheet: type: object additionalProperties: false description: Les postes du bilan demandés par leur nom. Seulement avec `detail=true`. properties: operatingProfit: type: number depreciation: type: number staffCosts: type: number totalAssets: type: number description: Le total du bilan. totalDebt: type: number interestPaid: type: number description: Le coût des dettes pour l'exercice. 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.