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

# Veldenoverzicht

> Elk veld dat de REST API en de MCP-tools teruggeven, en wat het betekent.

Elk veld dat de API teruggeeft, gegroepeerd zoals in het profiel. Lege velden blijven weg uit een antwoord en worden nooit als `null` verstuurd.

## Identiteit

| Veld | Type | Betekenis |
| - | - | - |
| `enterpriseNumber` | string | Belgisch ondernemingsnummer, genormaliseerd naar `BE0712345630`. De sleutel voor elke andere route. Een klein deel van de records draagt in de plaats daarvan een buitenlandse identificatie |
| `nameNl` | string | Juridische naam, Nederlands |
| `nameFr` | string | Juridische naam, Frans |
| `abbreviationNl` | string | Geregistreerde afkorting |
| `commercialName` | string | Handelsnaam, als er een geregistreerd is |

## Zoekresultaten

Elk item in `companies` van `GET /v1/companies`.

| Veld | Type | Betekenis |
| - | - | - |
| `enterpriseNumber` | string | De sleutel voor elke andere route |
| `name` | string | De naam die overeenkwam: juridisch, commercieel, Nederlands of Frans |
| `employees` | number | Het cijfer van het register zelf. Kan verschillen van `financials.employees` in het profiel, dat uit de laatste neerlegging komt |
| `statusCode` | string | Ruwe KBO-statuscode. **Zonder label** |

## Status en levensloop

| Veld | Type | Betekenis |
| - | - | - |
| `statusCode` | string | Ruwe KBO-statuscode, bijvoorbeeld `AC`. **Zonder label** |
| `juridicalFormCode` | string | Ruwe code van de rechtsvorm. **Zonder label** |
| `juridicalSituationCode` | string | Ruwe code van de rechtstoestand |
| `typeOfEnterpriseCode` | string | Natuurlijk persoon of rechtspersoon, als code |
| `deleted` | boolean | In het bronregister gemarkeerd als geschrapt. De gegevens zijn historisch |
| `startDate` | date | Datum van inschrijving |
| `endDate` | date | Datum van stopzetting, als die er is |

## Contact en activiteit

| Veld | Type | Betekenis |
| - | - | - |
| `street` | string | Maatschappelijke zetel, straat en nummer |
| `zipCode` | string | Postcode |
| `city` | string | Gemeente |
| `telephone` | string | Als geregistreerd |
| `email` | string | Als geregistreerd |
| `website` | string | Als geregistreerd |
| `activities` | string | Een samengestelde string: `MAIN :: 006 :: 2025 :: 58120`, herhaald en gescheiden door `;`. Het laatste deel is de NACE-code en het derde een jaartal. De eerste twee zijn broncodes zonder gepubliceerde betekenis |

## Financiële gegevens

Kerncijfers uit de meest recente neerlegging, onder `financials` in het profiel, en op elke rij van de route voor financiële gegevens. Ontbreekt volledig als de neerlegging geen cijfers bevatte.

| Veld | Type | Betekenis |
| - | - | - |
| `closingDate` | date | Laatste dag van het boekjaar waarop de cijfers betrekking hebben |
| `reference` | string | De referentie van de neerlegging bij de Nationale Bank, waarmee u een cijfer kunt controleren |
| `schemaType` | string | `full`, `abbreviated` enzovoort. Een onderneming die van schema verandert, rapporteert een ander detailniveau |
| `corrected` | boolean | Deze neerlegging verving een eerdere voor dezelfde periode. Dit is het cijfer dat telt |
| `comparative` | boolean | Overgenomen uit de kolom van het vorige boekjaar in een latere neerlegging. De referentie kan niet worden opgezocht |
| `employees` | number | Gemiddeld aantal voltijdsequivalenten (VTE) over de periode, niet het aantal personen. Bewust een decimaal getal |
| `equity` | number | EUR |
| `operatingIncome` | number | EUR |
| `ebitda` | number | EUR. Een cijfer afgeleid door de bron: Belgische jaarrekeningen hebben geen EBITDA-post |
| `resultForPeriod` | number | EUR |
| `healthIndicator` | number | De score van de bron, een geheel getal van 1 tot 10. De methode is niet gepubliceerd |

## Financiële gegevens, met `detail=true`

Twee objecten die aan elke rij van de route voor financiële gegevens worden toegevoegd. Bedragen in EUR.

| Veld | Type | Betekenis |
| - | - | - |
| `cashFlow.operating`, `.investing`, `.financing`, `.free` | number | Het neergelegde kasstroomoverzicht |
| `cashFlow.cashAtPeriodEnd` | number | Liquide middelen op de afsluitdatum |
| `cashFlow.distributionsToOwners` | number | Dividenden en andere uitkeringen aan de eigenaars, zoals neergelegd |
| `balanceSheet.operatingProfit`, `.depreciation`, `.staffCosts` | number | Benoemde posten uit de neerlegging |
| `balanceSheet.totalAssets` | number | Het balanstotaal |
| `balanceSheet.totalDebt`, `.interestPaid` | number | Schulden, en de kost van die schulden over de periode |

## Eigendom

Eén vorm voor elk item in `shareholders` en `participations`.

| Veld | Type | Betekenis |
| - | - | - |
| `name`, `enterpriseNumber` | string | De andere partij. Het nummer is niet altijd Belgisch |
| `stakePercent` | number | Het rechtstreekse belang als echt percentage: 50 betekent de helft |
| `indirectPercent` | number | Een belang via een andere entiteit, op dezelfde schaal |
| `shareClass` | string | De aandelencategorie zoals neergelegd, in de taal van de neerlegging |
| `asOf` | date | Het einde van de periode waarop de neerlegging betrekking heeft, zodat u de ouderdom van een belang kunt inschatten |
| `sourceSystem`, `sourceReference` | string | Waar het belang gelezen werd. `NBB`-referenties komen overeen met de jaarrekeningen en kunnen worden opgezocht |
| `exact` | boolean | Hoe zeker de bron is dat de link precies onderbouwd is. `false` wijst op een verouderd of afgeleid item |

## Personen

Eén item per mandaat in `people`.

| Veld | Type | Betekenis |
| - | - | - |
| `lastName`, `firstName` | string | De persoon |
| `category` | string | `ADMINISTER`, `SHAREHOLDER`, `LOCALPOLITICALMANDATE` of `OTHERMANDATE` |
| `role` | string | Bij `ADMINISTER` een broncode zonder label, zoals `13`. Anders de rol in woorden, in de taal van de neerlegging |
| `profession` | string | Zoals neergelegd |
| `startDate`, `endDate` | date | De einddatum is meestal het einde van de termijn, niet de dag waarop de persoon vertrok |
| `current` | boolean | Of het mandaat vandaag wordt uitgeoefend. **Lees dit, niet de datums** |
| `viaCompany`, `viaEnterpriseNumber` | string | Ingevuld als het mandaat via een vennootschap wordt uitgeoefend, met deze persoon als vaste vertegenwoordiger |
| `sourceSystem`, `sourceReference` | string | Waar het mandaat gelezen werd |

## Beschikbaarheidsvlaggen

`has` zegt wat de bron voor deze onderneming heeft, zonder het op te halen, zodat een agent of een taak kan beslissen of een vervolgaanroep de moeite waard is. **Een vlag op true is een bovengrens**: ze betekent dat de bron de dataset heeft, niet dat een aanroep rijen zal teruggeven. De meeste ondernemingen met een vlag voor participaties hebben niets wat de eigendomsroute kan teruggeven.

| Veld | Betekenis |
| - | - |
| `has.annualAccounts` | Er zijn neergelegde jaarrekeningen. Lees ze met de route voor financiële gegevens |
| `has.participations` | Er zijn participaties in de bron. Lees ze met de eigendomsroute |
| `has.accountants` | Er is een boekhouder of revisor bekend. Nog niet beschikbaar |
| `has.valuations` | Er is een waardering. Nog niet beschikbaar |
| `has.socialBalances` | Er is een sociale balans. Nog niet beschikbaar |

## Herkomst

| Veld | Betekenis |
| - | - |
| `snapshotDate` | Wanneer dit record laatst ververst werd vanuit de bron. Elk antwoord is een antwoord op een bepaalde datum |


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