# Les chiffres par code NACEBEL en JSON

Obtenez pour chaque code NACEBEL le nombre de sociétés actives, dans toute la Belgique ou dans une province. Vous recevez des totaux et des répartitions, avec la date des chiffres.

## Comment obtenir les chiffres ?

Envoyez une requête GET avec un code de la NACEBEL 2025 : une section (F), une division (43), un groupe (432), une classe (4321), une sous-classe (43211) ou un code détaillé (4321101).

```
GET https://leadprimeur.be/api/v1/stats/nace/{code}
```

Pour une province, ajoutez province, avec l'une de ces valeurs :

| Valeur | Province |
|---|---|
| `brussels` | Région de Bruxelles-Capitale |
| `walloon-brabant` | Brabant wallon |
| `flemish-brabant` | Brabant flamand |
| `antwerp` | Anvers |
| `limburg` | Limbourg |
| `liege` | Liège |
| `namur` | Namur |
| `hainaut` | Hainaut |
| `luxembourg` | Luxembourg |
| `west-flanders` | Flandre-Occidentale |
| `east-flanders` | Flandre-Orientale |

## Que recevez-vous ?

Un objet JSON avec les chiffres dans data et la source dans meta.

| Champ | Signification |
|---|---|
| `code` | Le code NACEBEL |
| `nacebel_version` | La version de la NACEBEL |
| `level` | Le niveau : section, division, group, class, subclass ou detail |
| `description` | La description en néerlandais et en français |
| `province` | La province, ou null pour toute la Belgique |
| `companies` | Sociétés actives avec ce code comme activité |
| `main_activity` | Dont avec ce code comme activité principale |
| `founded_last_30_days` | Créées dans les 30 jours avant la date des chiffres |
| `founded_last_12_months` | Créées dans les 12 mois avant la date des chiffres |
| `with_website` | Avec un site web |
| `with_phone` | Avec un numéro de téléphone |
| `provinces` | Par province, pour toute la Belgique |
| `municipalities` | Par commune, pour une province |
| `legal_forms` | Par forme juridique |
| `founded_per_month` | Créées par mois, les 24 derniers mois complets |
| `data_date` | La date des chiffres |
| `updated_at` | Quand ces chiffres ont changé pour la dernière fois |
| `pages` | La page avec ces chiffres, en néerlandais et en français |
| `meta` | La source et comment la citer, en néerlandais et en français |

## À quoi ressemble une réponse ?

La réponse pour le code NACEBEL 43211, avec les chiffres d'aujourd'hui :

```
GET https://leadprimeur.be/api/v1/stats/nace/43211
```

```json
{
    "data": {
        "code": "43211",
        "nacebel_version": 2025,
        "level": "subclass",
        "description": {
            "nl": "Algemene elektrotechnische installatiewerken",
            "fr": "Travaux généraux d'installation électrotechnique"
        },
        "province": null,
        "companies": 53827,
        "main_activity": 13509,
        "founded_last_30_days": 143,
        "founded_last_12_months": 3259,
        "with_website": 2214,
        "with_phone": 706,
        "provinces": [
            {
                "province": "flemish-brabant",
                "companies": 9572
            },
            {
                "province": "antwerp",
                "companies": 9207
            },
            {
                "province": "east-flanders",
                "companies": 8403
            },
            {
                "province": "west-flanders",
                "companies": 6652
            },
            {
                "province": "limburg",
                "companies": 5186
            },
            {
                "province": "brussels",
                "companies": 4608
            },
            {
                "province": "hainaut",
                "companies": 3213
            },
            {
                "province": "liege",
                "companies": 2881
            },
            {
                "province": "walloon-brabant",
                "companies": 1954
            },
            {
                "province": "namur",
                "companies": 1504
            },
            {
                "province": "luxembourg",
                "companies": 647
            }
        ],
        "legal_forms": [
            {
                "legal_form": "bv",
                "name": {
                    "nl": "BV",
                    "fr": "SRL"
                },
                "companies": 46223
            },
            {
                "legal_form": "commv",
                "name": {
                    "nl": "CommV",
                    "fr": "SComm"
                },
                "companies": 3452
            },
            {
                "legal_form": "nv",
                "name": {
                    "nl": "NV",
                    "fr": "SA"
                },
                "companies": 2569
            },
            {
                "legal_form": "vof",
                "name": {
                    "nl": "VOF",
                    "fr": "SNC"
                },
                "companies": 1392
            },
            {
                "legal_form": "cv",
                "name": {
                    "nl": "CV",
                    "fr": "SC"
                },
                "companies": 191
            }
        ],
        "founded_per_month": [
            {
                "month": "2024-10",
                "companies": 412
            },
            {
                "month": "2024-11",
                "companies": 306
            },
            {
                "month": "2024-12",
                "companies": 464
            },
            {
                "month": "2025-01",
                "companies": 398
            },
            {
                "month": "2025-02",
                "companies": 285
            },
            {
                "month": "2025-03",
                "companies": 275
            },
            {
                "month": "2025-04",
                "companies": 309
            },
            {
                "month": "2025-05",
                "companies": 226
            },
            {
                "month": "2025-06",
                "companies": 224
            },
            {
                "month": "2025-07",
                "companies": 271
            },
            {
                "month": "2025-08",
                "companies": 176
            },
            {
                "month": "2025-09",
                "companies": 269
            },
            {
                "month": "2025-10",
                "companies": 342
            },
            {
                "month": "2025-11",
                "companies": 243
            },
            {
                "month": "2025-12",
                "companies": 484
            },
            {
                "month": "2026-01",
                "companies": 323
            },
            {
                "month": "2026-02",
                "companies": 312
            },
            {
                "month": "2026-03",
                "companies": 285
            },
            {
                "month": "2026-04",
                "companies": 289
            },
            {
                "month": "2026-05",
                "companies": 195
            },
            {
                "month": "2026-06",
                "companies": 273
            },
            {
                "month": "2026-07",
                "companies": 245
            },
            {
                "month": "2026-08",
                "companies": 161
            },
            {
                "month": "2026-09",
                "companies": 173
            }
        ],
        "data_date": "2026-10-07",
        "updated_at": "2026-10-08T09:44:32+02:00",
        "pages": {
            "nl": "https://leadprimeur.be/nl/nacebel/43211-algemene-elektrotechnische-installatiewerken",
            "fr": "https://leadprimeur.be/fr/nacebel/43211-travaux-generaux-dinstallation-electrotechnique"
        }
    },
    "meta": {
        "source": {
            "nl": "Bron: Kruispuntbank van Ondernemingen (KBO Open Data), FOD Economie, stand 07/10/2026",
            "fr": "Source : Banque-Carrefour des Entreprises (BCE Open Data), SPF Economie, situation au 07/10/2026"
        },
        "attribution": {
            "nl": "Bron: LeadPrimeur.be op basis van KBO Open Data, stand 07/10/2026",
            "fr": "Source : LeadPrimeur.be sur la base de BCE Open Data, situation au 07/10/2026"
        },
        "documentation": {
            "nl": "https://leadprimeur.be/nl/api",
            "fr": "https://leadprimeur.be/fr/api"
        }
    }
}
```

## Quels codes de statut recevez-vous ?

- `200`: Les chiffres.
- `404`: Un code inconnu, ou un code sans sociétés dans cette zone.
- `422`: Une valeur inconnue pour province.
- `429`: Plus de 60 requêtes en une minute depuis la même adresse IP. Patientez un peu.

## Comment citer la source ?

Mentionnez à chaque utilisation : Source : LeadPrimeur.be sur la base de BCE Open Data, situation au 07/10/2026. Ce texte figure aussi dans meta.attribution.

Source : Banque-Carrefour des Entreprises (BCE Open Data), SPF Economie, situation au 07/10/2026
