Branches

Branch	Every branch in Belgium of a foreign company. Its number, name and start date.
Address	Where the branch is.

Request

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

curl

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

Node.js

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

Python

import requests

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

Answer

Counts as 1 requestJSON

{
  "enterprise_number": "0123.456.749",
  "branches": [
    {
      "branch_number": "9.123.456.744",
      "name": "Belscope Antwerpen",
      "start_date": "2020-06-01",
      "address": {
        "full": "Voorbeeldlaan 5 bus 2, 2000 Antwerpen",
        "street": "Voorbeeldlaan",
        "house_number": "5",
        "box": "2",
        "postal_code": "2000",
        "municipality": "Antwerpen",
        "country": "België",
        "struck_off_date": null
      }
    }
  ]
}

Fields 14What every field in the answer means

Field	Type	Description	Nullable
enterprise_number	text	The enterprise number of the foreign company the branches belong to.
branches	list	The foreign company's branches in Belgium. The newest first; one without a known start date last.	Empty list when the company has none (only foreign companies have branches).
branch_number	text	The branch's own number, always as 9.123.456.744.
name	text	The branch's name.	Null for most branches.
start_date	date	The day the branch started.	Null when it is not known.
address	block	The branch's 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.