# Cijfers per NACEBEL-code als JSON

Vraag voor elke NACEBEL-code op hoeveel actieve vennootschappen er zijn, in heel België of in één provincie. Je krijgt tellingen en verdelingen, met de datum van de cijfers.

## Hoe vraag je cijfers op?

Stuur een GET-verzoek met een code van NACEBEL 2025: een sectie (F), een afdeling (43), een groep (432), een klasse (4321), een subklasse (43211) of een detailcode (4321101).

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

Voor één provincie voeg je province toe, met een van deze waarden:

| Waarde | Provincie |
|---|---|
| `brussels` | Brussels Hoofdstedelijk Gewest |
| `walloon-brabant` | Waals-Brabant |
| `flemish-brabant` | Vlaams-Brabant |
| `antwerp` | Antwerpen |
| `limburg` | Limburg |
| `liege` | Luik |
| `namur` | Namen |
| `hainaut` | Henegouwen |
| `luxembourg` | Luxemburg |
| `west-flanders` | West-Vlaanderen |
| `east-flanders` | Oost-Vlaanderen |

## Wat krijg je terug?

Een JSON-object met de cijfers in data en de bron in meta.

| Veld | Betekenis |
|---|---|
| `code` | De NACEBEL-code |
| `nacebel_version` | De versie van NACEBEL |
| `level` | Het niveau: section, division, group, class, subclass of detail |
| `description` | De omschrijving in het Nederlands en het Frans |
| `province` | De provincie, of null voor heel België |
| `companies` | Actieve vennootschappen met deze code als activiteit |
| `main_activity` | Daarvan met deze code als hoofdactiviteit |
| `founded_last_30_days` | Opgericht in de 30 dagen voor de datum van de cijfers |
| `founded_last_12_months` | Opgericht in de 12 maanden voor de datum van de cijfers |
| `with_website` | Met een website |
| `with_phone` | Met een telefoonnummer |
| `provinces` | Per provincie, voor heel België |
| `municipalities` | Per gemeente, voor één provincie |
| `legal_forms` | Per rechtsvorm |
| `founded_per_month` | Opgericht per maand, de laatste 24 volledige maanden |
| `data_date` | De datum van de cijfers |
| `updated_at` | Wanneer deze cijfers het laatst veranderden |
| `pages` | De pagina met deze cijfers, in het Nederlands en het Frans |
| `meta` | De bron en hoe je die vermeldt, in het Nederlands en het Frans |

## Hoe ziet een antwoord eruit?

Het antwoord voor NACEBEL 43211, met de cijfers van vandaag:

```
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"
        }
    }
}
```

## Welke statuscodes krijg je?

- `200`: De cijfers.
- `404`: Een onbekende code, of een code zonder vennootschappen in dat gebied.
- `422`: Een onbekende waarde voor province.
- `429`: Meer dan 60 vragen in een minuut vanaf hetzelfde IP-adres. Wacht dan even.

## Hoe vermeld je de bron?

Vermeld bij elk gebruik: Bron: LeadPrimeur.be op basis van KBO Open Data, stand 07/10/2026. Die tekst staat ook in meta.attribution.

Bron: Kruispuntbank van Ondernemingen (KBO Open Data), FOD Economie, stand 07/10/2026
