nacebel.codes
Auf der Suche nach einer besseren Buchhaltungslösung? Financica bietet KI-native Buchhaltung — 3 Monate gratis.financica.app

NACE-BEL 2025 API

Dokumentation der öffentlichen API für Suche und Abfrage im NACE-BEL 2025 Verzeichnis.

Endpunkte

2

Liste/Suche und Detailabfrage

Max. Seitengröße

500

Gut für Massenabrufe und Exporte

Authentifizierung

Keine

Kontaktieren Sie uns für höhere Limits und Support

Basis-URL und Authentifizierung

Anfragen sind öffentlich, Sie müssen also keinen Header senden wie Authorization.

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

Abfrageparameter

Der Listen-Endpunkt unterstützt Paginierung, Suche und Filterung nach Ebene.

ParameterTypBeschreibung
qstringSuchbegriff für einen Code oder Titel. Weglassen, um das Verzeichnis aufzulisten.
pagenumberSeitenzahl für die Paginierung. Standard: 1.
limitnumberEinträge pro Seite. Standard: 100. Maximum: 500.
levelnumberMinimale NACE-BEL-Ebene, die einbezogen wird, von 2 bis 5.
GET
/api/v1/nacebel-codes/2025

Codes auflisten und durchsuchen

Rufen Sie paginierte Codes ab oder durchsuchen Sie Titel und Codenummern im öffentlichen Verzeichnis.

Beispielanfrage

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

Beispielantwort

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

Code-Details abrufen

Rufen Sie einen Code über seine punktlose Kennung ab und schließen Sie seine direkten Untercodes ein.

Beispielanfrage

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

Beispielantwort

{
  "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"
  ]
}

Fehler und Drosselung

Die API gibt standardmäßige HTTP-Statuscodes zurück. Wenn Sie einen fehlenden Code anfragen, erhalten Sie eine Antwort mit dem Status 404.

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

Öffentlicher Datenverkehr wird über eine gemeinsam genutzte Infrastruktur bereitgestellt. Zum Schutz des Dienstes kann übermäßige Nutzung gedrosselt werden mit 429 Too Many Requests.

Höhere Ratenlimits oder Support nötig?

Die öffentliche API wird wie besehen bereitgestellt. Wenn Sie eine höhere Dauerlast, operativen Support oder einen individuelleren Integrationsweg benötigen, schreiben Sie uns, und wir finden eine Lösung.

Typische Gründe für eine Kontaktaufnahme

  • Höheres dauerhaftes Anfragevolumen
  • Vorrangige Problemlösung
  • Integrationsberatung für den Produktiveinsatz
  • Fragen zum kommerziellen oder individuellen Datenzugriff