Employees

FTE / VTE	Full-time equivalents, on average over the financial year.
Headcount	How many people work full-time and how many part-time.
At year end	Full-time, part-time and FTE: for everyone, for white-collar and for blue-collar.

Request

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

curl

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

Node.js

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

Python

import requests

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

Answer

Counts as 1 requestJSON

{
  "enterprise_number": "0123.456.749",
  "year_end": "2025-12-31",
  "fte": 27.9,
  "headcount": {
    "full_time": 25.8,
    "part_time": 2.9
  },
  "at_year_end": {
    "full_time": 27,
    "part_time": 3,
    "fte": 29.1,
    "white_collar": {
      "full_time": 13,
      "part_time": 2,
      "fte": 14.1
    },
    "blue_collar": {
      "full_time": 14,
      "part_time": 1,
      "fte": 15
    }
  }
}

Fields 18What 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.
fte	number	The size of the company: the average number of employees over the financial year, in full-time equivalents (a part-timer counts for less than 1), such as 27.9. Checked against the company's other figures.	Null when the annual account has no FTE, or when the company's own figures clearly contradict it.
headcount	block	The number of people (not in full-time equivalents), on average over the financial year. Together they are usually a little more than fte: a part-timer is one person but less than one full-time job.	Null when the annual account does not give it.
full_time	number	Full-time employees, in persons.	Null when it is not given.
part_time	number	Part-time employees, in persons.	Null when it is not given.
at_year_end	block	On the last day of the financial year (op de afsluitingsdatum van het boekjaar), the only moment the annual account splits white-collar and blue-collar employees.	Null when the annual account does not give it.
full_time	number	All employees working full-time, in persons.	Null when it is not given.
part_time	number	All employees working part-time, in persons.	Null when it is not given.
fte	number	All employees, in full-time equivalents. White-collar and blue-collar are part of it; the rest is management and others, such as interns.	Null when it is not given.
white_collar	block	Bedienden: white-collar employees.	Null when the annual account does not give them.
full_time	number	Full-time, in persons.	Null when it is not given.
part_time	number	Part-time, in persons.	Null when it is not given.
fte	number	In full-time equivalents.	Null when it is not given.
blue_collar	block	Arbeiders: blue-collar employees.	Null when the annual account does not give them.
full_time	number	Full-time, in persons.	Null when it is not given.
part_time	number	Part-time, in persons.	Null when it is not given.
fte	number	In full-time equivalents.	Null when it is not given.