NACE-BEL 2025 API Documentation

Access the complete NACEBEL 2025 classification system programmatically.

Authentication

An API key is required to use the NACE-BEL 2025 API. You can obtain a key by subscribing to one of our plans below. All API requests must include the API key in the Authorization header as a Bearer token.

Authorization: Bearer YOUR_API_KEY

API Endpoints

List & Search Codes

GET

/api/v1/nacebel-codes/2025

Retrieve a paginated list of all NACEBEL codes, or search for codes based on a query.

Query Parameters

Parameter	Type	Description
q	string	Search query for code or description. If omitted, returns all codes.
page	number	Page number for pagination. Default: `1`.
limit	number	Number of items per page. Default: `100`, Max: `500`.
level	number	Minimum NACEBEL level to include (2-5).

Example Request (Search)

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

Example Response

{
  "data": [
    {
      "level": 2,
      "code": "01.1",
      "titles": {
        "en": "Growing of non-perennial crops",
        "de": "Anbau von einjährigen Pflanzen",
        "fr": "Cultures non permanentes",
        "nl": "Teelt van eenjarige gewassen"
      },
      "description": { "en": "", "de": "", "fr": "", "nl": "" }
    }
  ],
  "totalPages": 25,
  "totalItems": 2458
}

Get Code Details

GET

/api/v1/nacebel-codes/2025/{id}

Retrieve the full details for a single NACEBEL code, including its direct children. The {id} should be the code without any dots (e.g., 0111).

Example Request

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

Example Response

{
  "level": 4,
  "code": "01.11",
  "titles": {
    "en": "Growing of cereals (except rice), leguminous crops and oil seeds",
    "de": "Anbau von Getreide (ohne Reis), Hülsenfrüchten und Ölsaaten",
    "fr": "Culture de céréales (à l'exception du riz), de légumineuses et de graines oléagineuses",
    "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"
  ]
}

Example Not Found Response

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

Rate Limiting

API access is rate-limited to ensure fair usage. The specific limits depend on your subscription plan. Exceeding the rate limit will result in a 429 Too Many Requests error.

Get Your API Key

Choose the plan that fits your needs and start accessing the NACE-BEL 2025 API today.