> ## 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. # Neergelegde jaarrekeningen ophalen > De neergelegde cijfers, één rij per boekjaar, het nieuwste eerst. Een verbetering vervangt de neerlegging die ze verbetert en wordt gemarkeerd in plaats van verborgen. Elk boekjaar kost credits, dus tien jaar kost tien keer één jaar. ## OpenAPI ````yaml /api-reference/openapi.nl.json get /v1/companies/{id}/financials 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}/financials: get: tags: - Companies summary: Neergelegde jaarrekeningen ophalen description: >- De neergelegde cijfers, één rij per boekjaar, het nieuwste eerst. Een verbetering vervangt de neerlegging die ze verbetert en wordt gemarkeerd in plaats van verborgen. Elk boekjaar kost credits, dus tien jaar kost tien keer één jaar. operationId: getCompanyFinancials parameters: - $ref: '#/components/parameters/id' - name: years in: query required: false description: >- Hoeveel boekjaren terugkomen, 1 tot 20. Een ontbrekende, nul-, negatieve of grotere waarde geeft 10. schema: type: integer default: 10 - name: detail in: query required: false description: >- `true` voegt het kasstroomoverzicht en de benoemde balansposten toe aan elk boekjaar. schema: type: boolean default: false responses: '200': description: >- De boekjaren. Een lege lijst als de onderneming niets heeft neergelegd. 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/FinancialsReply' example: periods: - 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 cashFlow: operating: 4410228.35 investing: -1876340.12 financing: -1504377.8 free: 2533888.23 cashAtPeriodEnd: 1388902.41 distributionsToOwners: 600000 balanceSheet: operatingProfit: 3480112.9 depreciation: 1328006.48 staffCosts: 9876540.21 totalAssets: 31902554.7 totalDebt: 8044120.33 interestPaid: 288410.12 '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: FinancialsReply: type: object additionalProperties: false required: - periods properties: periods: type: array items: $ref: '#/components/schemas/Period' 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' 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.