Public API documentation for search and lookup across the NACE-BEL 2025 directory.
Endpoints
2
List/search and detail lookup
Max page size
500
Good for bulk reads and exports
Authentication
None
Contact us for higher limits and support
Requests are public, so you do not need to send a header such as Authorization.
https://nacebel.codes/api/v1/nacebel-codes/2025The list endpoint supports paging, search, and level filtering.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search query for a code or title. Omit it to list the directory. |
| page | number | Page number for pagination. Default: 1. |
| limit | number | Items per page. Default: 100. Maximum: 500. |
| level | number | Minimum NACE-BEL level to include, from 2 to 5. |
/api/v1/nacebel-codes/2025Retrieve paginated codes or search titles and code numbers across the public directory.
Example request
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 einjahrigen Pflanzen",
"fr": "Cultures non permanentes",
"nl": "Teelt van eenjarige gewassen"
},
"description": { "en": "", "de": "", "fr": "", "nl": "" }
}
],
"totalPages": 25,
"totalItems": 2458
}/api/v1/nacebel-codes/2025/{id}Fetch one code by its dot-less identifier and include its direct children.
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), 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"
]
}The API returns standard HTTP status codes. If you request a missing code, you receive a response with status 404.
{
"error": "NACEBEL code not found."
}Public traffic is served on shared infrastructure. To protect the service, excessive usage may be throttled with 429 Too Many Requests.
The public API is available as-is. If you need heavier sustained usage, operational support, or a more tailored integration path, email us and we can work out a setup.
Typical reasons to reach out