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

# Référence des champs

> Chaque champ que renvoient l'API REST et les outils MCP, et sa signification.

Chaque champ que renvoie l'API, regroupé comme dans le profil. Les champs vides sont omis de la réponse, jamais envoyés à `null`.

## Identité

| Champ | Type | Signification |
| - | - | - |
| `enterpriseNumber` | string | Numéro d'entreprise belge, normalisé en `BE0712345630`. La clé de toutes les autres routes. Une petite partie des enregistrements porte plutôt un identifiant étranger |
| `nameNl` | string | Dénomination légale, en néerlandais |
| `nameFr` | string | Dénomination légale, en français |
| `abbreviationNl` | string | Abréviation enregistrée |
| `commercialName` | string | Nom commercial, s'il est enregistré |

## Résultats de recherche

Chaque entrée de `companies` renvoyée par `GET /v1/companies`.

| Champ | Type | Signification |
| - | - | - |
| `enterpriseNumber` | string | La clé de toutes les autres routes |
| `name` | string | Le nom qui a correspondu : légal, commercial, néerlandais ou français |
| `employees` | number | Le chiffre propre au registre. Peut différer de `financials.employees` dans le profil, qui provient du dernier dépôt |
| `statusCode` | string | Code de statut BCE brut. **Sans libellé** |

## Statut et cycle de vie

| Champ | Type | Signification |
| - | - | - |
| `statusCode` | string | Code de statut BCE brut, par exemple `AC`. **Sans libellé** |
| `juridicalFormCode` | string | Code brut de forme juridique. **Sans libellé** |
| `juridicalSituationCode` | string | Code brut de situation juridique |
| `typeOfEnterpriseCode` | string | Personne physique ou personne morale, sous forme de code |
| `deleted` | boolean | Marquée comme supprimée dans le registre source. Les données sont historiques |
| `startDate` | date | Date d'inscription |
| `endDate` | date | Date de cessation, le cas échéant |

## Coordonnées et activités

| Champ | Type | Signification |
| - | - | - |
| `street` | string | Siège social, rue et numéro |
| `zipCode` | string | Code postal |
| `city` | string | Commune |
| `telephone` | string | S'il est enregistré |
| `email` | string | S'il est enregistré |
| `website` | string | S'il est enregistré |
| `activities` | string | Une chaîne compacte : `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 une année. Les deux premières sont des codes de la source sans signification publiée |

## Comptes annuels

Les chiffres clés du dépôt le plus récent, sous `financials` dans le profil, et sur chaque ligne de la route des comptes annuels. Totalement absent lorsque le dépôt ne contenait aucun chiffre.

| Champ | Type | Signification |
| - | - | - |
| `closingDate` | date | Dernier jour de l'exercice couvert par les chiffres |
| `reference` | string | La référence du dépôt à la Banque nationale, qui permet de vérifier un chiffre |
| `schemaType` | string | `full`, `abbreviated`, etc. Une entreprise qui change de schéma publie un autre niveau de détail |
| `corrected` | boolean | 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` | boolean | Repris de la colonne de l'exercice précédent d'un dépôt ultérieur. Sa référence ne peut pas être consultée |
| `employees` | number | Moyenne des équivalents temps plein (ETP) sur l'exercice, pas un nombre de personnes. Fractionnaire par nature |
| `equity` | number | EUR |
| `operatingIncome` | number | EUR |
| `ebitda` | number | EUR. Le chiffre calculé par la source : les comptes annuels belges n'ont pas de poste EBITDA |
| `resultForPeriod` | number | EUR |
| `healthIndicator` | number | Le score de la source, un nombre entier de 1 à 10. La méthode n'est pas publiée |

## Comptes annuels, avec `detail=true`

Deux objets ajoutés à chaque ligne de la route des comptes annuels. Montants en EUR.

| Champ | Type | Signification |
| - | - | - |
| `cashFlow.operating`, `.investing`, `.financing`, `.free` | number | Le tableau des flux de trésorerie déposé |
| `cashFlow.cashAtPeriodEnd` | number | Trésorerie à la date de clôture |
| `cashFlow.distributionsToOwners` | number | Dividendes et autres distributions aux actionnaires, tels que déposés |
| `balanceSheet.operatingProfit`, `.depreciation`, `.staffCosts` | number | Postes nommés du dépôt |
| `balanceSheet.totalAssets` | number | Le total du bilan |
| `balanceSheet.totalDebt`, `.interestPaid` | number | Les dettes, et le coût de la dette sur l'exercice |

## Actionnariat

Une même structure pour chaque entrée de `shareholders` et de `participations`.

| Champ | Type | Signification |
| - | - | - |
| `name`, `enterpriseNumber` | string | L'autre partie. Le numéro n'est pas toujours belge |
| `stakePercent` | number | La participation directe, en vrai pourcentage : 50 signifie la moitié |
| `indirectPercent` | number | Une participation détenue via une autre entité, sur la même échelle |
| `shareClass` | string | La catégorie d'actions telle que déposée, dans la langue du dépôt |
| `asOf` | date | La fin de l'exercice couvert par le dépôt, pour pouvoir dater une participation |
| `sourceSystem`, `sourceReference` | string | Où la participation a été lue. Les références `NBB` correspondent aux comptes annuels et peuvent être consultées |
| `exact` | boolean | La confiance de la source dans la précision du lien. La valeur `false` signale une entrée périmée ou déduite |

## Personnes

Une entrée par mandat dans `people`.

| Champ | Type | Signification |
| - | - | - |
| `lastName`, `firstName` | string | La personne |
| `category` | string | `ADMINISTER`, `SHAREHOLDER`, `LOCALPOLITICALMANDATE` or `OTHERMANDATE` |
| `role` | string | Pour `ADMINISTER`, un code source sans libellé, comme `13`. Sinon, le rôle en toutes lettres, dans la langue du dépôt |
| `profession` | string | Telle que déposée |
| `startDate`, `endDate` | date | La date de fin est généralement la fin du terme, pas le jour où la personne est partie |
| `current` | boolean | Indique si le mandat est exercé aujourd'hui. **Lisez ce champ, pas les dates** |
| `viaCompany`, `viaEnterpriseNumber` | string | Renseignés lorsque le mandat est exercé via une société, dont cette personne est le représentant permanent |
| `sourceSystem`, `sourceReference` | string | Où le mandat a été lu |

## Indicateurs de disponibilité

`has` indique ce que la source détient pour cette entreprise sans aller le chercher, pour qu'un agent ou une tâche puisse décider si un appel supplémentaire en vaut la peine. **Un indicateur à true est une borne supérieure** : il signifie que la source possède le jeu de données, pas qu'un appel renverra des lignes. La plupart des entreprises marquées pour les participations n'ont rien que la route d'actionnariat puisse renvoyer.

| Champ | Signification |
| - | - |
| `has.annualAccounts` | Des comptes déposés existent. Lisez-les avec la route des comptes annuels |
| `has.participations` | Des participations existent dans la source. Lisez-les avec la route d'actionnariat |
| `has.accountants` | Un comptable ou un réviseur est enregistré. Pas encore servi |
| `has.valuations` | Une valorisation existe. Pas encore servie |
| `has.socialBalances` | Un bilan social existe. Pas encore servi |

## Provenance

| Champ | Signification |
| - | - |
| `snapshotDate` | Date de la dernière actualisation de cet enregistrement depuis la source. Chaque réponse vaut à une date donnée |


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