> ## 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. # Een onderneming ophalen > Het profiel van één onderneming: namen, status, rechtsvorm, adres, contactgegevens, activiteiten, de nieuwste neergelegde cijfers, en vlaggen die zeggen welke andere datasets voor haar bestaan. ## OpenAPI ````yaml /api-reference/openapi.nl.json get /v1/companies/{id} 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}: get: tags: - Companies summary: Een onderneming ophalen description: >- Het profiel van één onderneming: namen, status, rechtsvorm, adres, contactgegevens, activiteiten, de nieuwste neergelegde cijfers, en vlaggen die zeggen welke andere datasets voor haar bestaan. operationId: getCompany parameters: - $ref: '#/components/parameters/id' responses: '200': description: Het profiel. 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: >- 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: Profile: type: object additionalProperties: false required: - enterpriseNumber - deleted - has properties: enterpriseNumber: type: string nameNl: type: string description: De Nederlandse naam. nameFr: type: string description: De Franse naam. abbreviationNl: type: string commercialName: type: string statusCode: type: string description: Ruwe KBO-code, zonder label. juridicalFormCode: type: string description: Ruwe KBO-code voor de rechtsvorm, zonder label. juridicalSituationCode: type: string description: Ruwe KBO-code, zonder label. typeOfEnterpriseCode: type: string description: Ruwe KBO-code, zonder label. deleted: type: boolean description: >- De onderneming bestaat niet meer. Teruggegeven in plaats van verborgen. 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: >- Een samengestelde tekst: `MAIN :: 006 :: 2025 :: 58120`, herhaald en gescheiden door `;`. Het laatste deel is de NACE-code en het derde deel is een jaar. De eerste twee delen zijn broncodes zonder gepubliceerde betekenis. financials: $ref: '#/components/schemas/Period' has: $ref: '#/components/schemas/Available' snapshotDate: type: string format: date description: >- Wanneer deze onderneming het laatst uit de bron is bijgewerkt. Elk antwoord geldt op een datum. Period: type: object additionalProperties: false description: Eén boekjaar, zoals neergelegd. Bedragen zijn in euro. required: - closingDate properties: closingDate: type: string format: date reference: type: string description: >- De referentie van de neerlegging bij de Nationale Bank van België, zodat u een cijfer kunt nakijken in het brondocument. schemaType: type: string description: >- Het schema van de neerlegging, zoals `full` of `abbreviated`. Een onderneming die van schema verandert, rapporteert een ander detailniveau. corrected: type: boolean description: >- Deze neerlegging verving een eerdere voor hetzelfde boekjaar. Dit is het geldende cijfer. comparative: type: boolean description: >- Deze cijfers komen uit de kolom van het vorige boekjaar in een latere neerlegging, niet uit een eigen neerlegging. De referentie kan niet worden opgezocht. employees: type: number description: >- Gemiddeld aantal voltijdse equivalenten over het boekjaar, niet het aantal personen. equity: type: number operatingIncome: type: number ebitda: type: number description: >- Het afgeleide cijfer van de bron. Een Belgische jaarrekening heeft geen EBITDA-post. resultForPeriod: type: number healthIndicator: type: number description: >- De score van de bron, een geheel getal van 1 tot 10. De methode is niet gepubliceerd. cashFlow: $ref: '#/components/schemas/CashFlow' balanceSheet: $ref: '#/components/schemas/BalanceSheet' Available: type: object additionalProperties: false description: >- Welke andere datasets de bron voor deze onderneming heeft. Een bovengrens: een vlag op true betekent dat de bron de dataset heeft, niet dat een oproep rijen teruggeeft. required: - annualAccounts - participations - accountants - valuations - socialBalances properties: annualAccounts: type: boolean description: Leesbaar via de route voor jaarrekeningen. participations: type: boolean description: Leesbaar via de route voor eigendom. accountants: type: boolean description: Neergelegd, nog niet geleverd door deze API. valuations: type: boolean description: Neergelegd, nog niet geleverd door deze API. socialBalances: type: boolean description: Neergelegd, nog niet geleverd door deze 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: Het neergelegde kasstroomoverzicht. Alleen met `detail=true`. properties: operating: type: number investing: type: number financing: type: number free: type: number cashAtPeriodEnd: type: number distributionsToOwners: type: number description: Dividenden en andere uitkeringen aan eigenaars, zoals neergelegd. BalanceSheet: type: object additionalProperties: false description: De balansposten die op naam worden gevraagd. Alleen met `detail=true`. properties: operatingProfit: type: number depreciation: type: number staffCosts: type: number totalAssets: type: number description: Het balanstotaal. totalDebt: type: number interestPaid: type: number description: De kosten van schulden voor het boekjaar. 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.