nacebel.codes
Op zoek naar een betere boekhoudoplossing? Financica biedt AI-native boekhouding — 3 maanden gratis.financica.app

NACE-BEL 2025 API

Documentatie van de openbare API voor zoeken en opzoeken in het NACE-BEL 2025-repertorium.

Endpoints

2

Lijst/zoeken en detailopzoeking

Max. paginagrootte

500

Geschikt voor bulklezingen en exports

Authenticatie

Geen

Neem contact op voor hogere limieten en ondersteuning

Basis-URL en authenticatie

Verzoeken zijn openbaar, dus u hoeft geen header te versturen zoals Authorization.

https://nacebel.codes/api/v1/nacebel-codes/2025

Queryparameters

Het lijst-endpoint ondersteunt paginering, zoeken en filteren op niveau.

ParameterTypeBeschrijving
qstringZoekterm voor een code of titel. Laat weg om de directory te tonen.
pagenumberPaginanummer voor paginering. Standaard: 1.
limitnumberItems per pagina. Standaard: 100. Maximum: 500.
levelnumberMinimaal NACE-BEL-niveau om op te nemen, van 2 tot 5.
GET
/api/v1/nacebel-codes/2025

Codes lijsten en zoeken

Haal gepagineerde codes op of doorzoek titels en codenummers in de openbare directory.

Voorbeeldverzoek

curl "https://nacebel.codes/api/v1/nacebel-codes/2025?q=software&level=4"

Voorbeeldantwoord

{
  "data": [
    {
      "level": 2,
      "code": "01.1",
      "titles": {
        "en": "Growing of non-perennial crops",
        "de": "Anbau von einjahrigen Pflanzen",
        "fr": "Cultures non permanentes",
        "nl": "Teelt van eenjarige gewassen"
      },
      "description": { "en": "", "de": "", "fr": "", "nl": "" }
    }
  ],
  "totalPages": 25,
  "totalItems": 2458
}
GET
/api/v1/nacebel-codes/2025/{id}

Codedetails opvragen

Haal één code op via zijn puntloze identificator en voeg de directe subcodes toe.

Voorbeeldverzoek

curl "https://nacebel.codes/api/v1/nacebel-codes/2025/0111"

Voorbeeldantwoord

{
  "level": 4,
  "code": "01.11",
  "titles": {
    "en": "Growing of cereals (except rice), leguminous crops and oil seeds",
    "de": "Anbau von Getreide (ohne Reis), Hulsenfruchten und Olsaaten",
    "fr": "Culture de cereales (a l'exception du riz), de legumineuses et de graines oleagineuses",
    "nl": "Teelt van granen (met uitzondering van rijst), peulgewassen en oliehoudende zaden"
  },
  "description": { "en": "", "de": "", "fr": "", "nl": "" },
  "childrenCodes": [
    "01.111",
    "01.112",
    "01.113",
    "01.119"
  ]
}

Fouten en beperking

De API geeft standaard HTTP-statuscodes terug. Vraagt u een onbestaande code op, dan krijgt u een antwoord met status 404.

{
  "error": "NACEBEL code not found."
}

Openbaar verkeer verloopt via gedeelde infrastructuur. Om de dienst te beschermen kan overmatig gebruik worden beperkt met 429 Too Many Requests.

Hogere limieten of ondersteuning nodig?

De openbare API is beschikbaar zoals ze is. Hebt u zwaarder aanhoudend gebruik, operationele ondersteuning of een meer op maat gemaakte integratie nodig, mail ons dan en we werken een opzet uit.

Typische redenen om contact op te nemen

  • Hoger aanhoudend aanvraagvolume
  • Prioritaire probleemoplossing
  • Integratiebegeleiding voor productiegebruik
  • Vragen over commerciële of aangepaste datatoegang