Establishments

Establishment	Every establishment of the company. Its number, name and start date.
Address	Where the establishment is.
Contacts	Its email addresses, phone numbers and websites.
Activities	Its main and secondary activity codes, with what they mean.

Request

GEThttps://api.belscope.be/v1/companies/{number}/establishments

curl

curl https://api.belscope.be/v1/companies/0400378485/establishments \
  -H "Authorization: Bearer YOUR_KEY"

Node.js

const response = await fetch('https://api.belscope.be/v1/companies/0400378485/establishments', {
  headers: { Authorization: 'Bearer YOUR_KEY' },
});
const data = await response.json();

Python

import requests

response = requests.get(
    'https://api.belscope.be/v1/companies/0400378485/establishments',
    headers={'Authorization': 'Bearer YOUR_KEY'},
)
data = response.json()

PHP

$context = stream_context_create([
    'http' => ['header' => 'Authorization: Bearer YOUR_KEY', 'ignore_errors' => true],
]);
$response = file_get_contents('https://api.belscope.be/v1/companies/0400378485/establishments', false, $context);
$data = json_decode($response, true);

C#

using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_KEY");
var response = await client.GetAsync("https://api.belscope.be/v1/companies/0400378485/establishments");
var data = await response.Content.ReadAsStringAsync();

Answer

Counts as 1 requestJSON

{
  "enterprise_number": "0123.456.749",
  "establishments": [
    {
      "establishment_number": "2.123.456.791",
      "name": "Belscope Gent",
      "start_date": "2018-02-01",
      "address": {
        "full": "Voorbeeldstraat 12 bus B, 9000 Gent",
        "street": "Voorbeeldstraat",
        "house_number": "12",
        "box": "B",
        "postal_code": "9000",
        "municipality": "Gent",
        "country": "België",
        "struck_off_date": null
      },
      "contacts": {
        "emails": [
          "gent@belscope.be"
        ],
        "phones": [
          "09 123 45 68"
        ],
        "websites": [
          "www.belscope.be"
        ]
      },
      "activities": {
        "main": [
          {
            "code": "62100",
            "description": "Ontwerpen van computerprogramma’s"
          }
        ],
        "secondary": []
      }
    }
  ]
}

Fields 23What every field in the answer means

Field	Type	Description	Nullable
enterprise_number	text	The enterprise number of the company the establishments belong to.
establishments	list	The company's establishments: the places where it works, such as shops and offices. The newest first; one without a known start date last.	Empty list when the company has none.
establishment_number	text	The establishment's own number, always as 2.123.456.791.
name	text	The establishment's name.	Null when it has none (about 1 in 4).
start_date	date	The day the establishment started.	Null when it is not known.
address	block	The establishment's address.	Null when the establishment has no address.
full	text	The whole address on one line, ready to show. The country is only added abroad.	Null when the address is not known.
street	text	The street.	Null when it is not known.
house_number	text	The house number.	Null when there is none.
box	text	The box number.	Null when there is none.
postal_code	text	The postal code.	Null when it is not known.
municipality	text	The municipality.	Null when it is not given.
country	text	België in Belgium, otherwise the country.	Null when it is not known.
struck_off_date	date	The day the address was officially struck off.	Null when not struck off.
contacts	block	How to reach the establishment.
emails	list	Email addresses.	Empty list when none.
phones	list	Phone numbers.	Empty list when none.
websites	list	Websites.	Empty list when none.
activities	block	What is done at the establishment, as codes from the Belgian activity list (NACE-BEL 2025).
main	list	The main activities.	Empty list when none.
secondary	list	The secondary activities, with the same fields as main. A code that is in main is not repeated here.	Empty list when none.
code	text	The activity code. An establishment can have a more precise KBO code of 7 digits; search takes codes of up to 5.
description	text	What the code means.