Directors

Directors	Every director, person or company, with name and address.
Mandates	Each director's roles, with start and end date.
Representatives	For a company director: the person who acts for it.

Request

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

curl

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

Node.js

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

Python

import requests

response = requests.get(
    'https://api.belscope.be/v1/companies/0400378485/directors',
    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/directors', 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/directors");
var data = await response.Content.ReadAsStringAsync();

Answer

Counts as 1 requestJSON

{
  "enterprise_number": "0123.456.749",
  "year_end": "2025-12-31",
  "directors": [
    {
      "entity_type": "Natuurlijk Persoon",
      "name": "An Janssens",
      "first_name": "An",
      "last_name": "Janssens",
      "enterprise_number": null,
      "other_number": null,
      "address": {
        "full": "Molenstraat 8, 9050 Gent",
        "street": "Molenstraat",
        "house_number": "8",
        "box": null,
        "postal_code": "9050",
        "municipality": "Gent",
        "country": "België"
      },
      "roles": [
        {
          "role": "Bestuurder",
          "start_date": "2020-06-10",
          "end_date": "2030-06-10"
        }
      ],
      "representatives": []
    },
    {
      "entity_type": "Rechtspersoon",
      "name": "Belscope Holding",
      "first_name": null,
      "last_name": null,
      "enterprise_number": "0123.456.848",
      "other_number": null,
      "address": {
        "full": "Voorbeeldlaan 5, 2000 Antwerpen",
        "street": "Voorbeeldlaan",
        "house_number": "5",
        "box": null,
        "postal_code": "2000",
        "municipality": "Antwerpen",
        "country": "België"
      },
      "roles": [
        {
          "role": "Gedelegeerd bestuurder",
          "start_date": "2018-02-01",
          "end_date": "2030-06-10"
        }
      ],
      "representatives": [
        {
          "name": "Jan Peeters",
          "first_name": "Jan",
          "last_name": "Peeters",
          "address": {
            "full": "Kerkstraat 3, 9000 Gent",
            "street": "Kerkstraat",
            "house_number": "3",
            "box": null,
            "postal_code": "9000",
            "municipality": "Gent",
            "country": "België"
          }
        }
      ]
    }
  ]
}

Fields 33What every field in the answer means

Field	Type	Description	Nullable
enterprise_number	text	The enterprise number, always as 0123.456.749.
year_end	date	The last day of the financial year these numbers come from: the newest annual account with figures (a year filed only as a PDF has none). Check it to know how recent the numbers are.	Null when the company has no annual account with figures.
directors	list	Everyone the annual account lists as director: first the people, then the companies, each in alphabetical order.	Empty list when it lists none, or when the company has no annual account.
entity_type	text	Natuurlijk Persoon for a person, Rechtspersoon for a company.
name	text	The full name of the person, or the name of the company, as written in the annual account.
first_name	text	The first name.	Null for a company.
last_name	text	The last name.	Null for a company.
enterprise_number	text	The Belgian enterprise number of a company director, as 0123.456.749. Ask for that company with it.	Null for a person, or for a company without a valid Belgian number.
other_number	text	The number of a company director that is not a valid Belgian enterprise number, such as a foreign registration number, as written.	Null when there is none.
address	block	The address of the director, as written in the annual account.	Null when the annual account gives none.
full	text	The whole address on one line, ready to show. The country is only added abroad.	Null when the annual account gives too little of the address to write it.
street	text	The street.	Null when it is not given.
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 given.
municipality	text	The municipality.	Null when it is not given.
country	text	The country, such as België.	Null when it is not given.
roles	list	The mandates of this director, in the order of the annual account.	Empty list when the annual account gives no mandate.
role	text	The role, such as Bestuurder, Gedelegeerd bestuurder or Zaakvoerder.	Null when the annual account gives no role, or a role that is not one of the official roles.
start_date	date	The day the mandate started.	Null when it is not given.
end_date	date	The day the mandate ends or ended. Often a planned date in the future.	Null when it is not given.
representatives	list	For a company director: the person who acts for it.	Empty list for a person, or when none is given.
name	text	The full name.
first_name	text	The first name.
last_name	text	The last name.
address	block	The address of the representative, as written in the annual account.	Null when the annual account gives none.
full	text	The whole address on one line, ready to show. The country is only added abroad.	Null when the annual account gives too little of the address to write it.
street	text	The street.	Null when it is not given.
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 given.
municipality	text	The municipality.	Null when it is not given.
country	text	The country, such as België.	Null when it is not given.