Skip to content
We regularly add fields and features to the Belscope API. This documentation always shows the current version.

Address

The registered address of the company.

AddressStreet, house number, box, postal code, municipality and country, and the full address.
Struck offThe day the address was struck off, when it was.

Request

GEThttps://api.belscope.be/v1/companies/{number}/address
curl https://api.belscope.be/v1/companies/0400378485/address \
-H "Authorization: Bearer YOUR_KEY"
const response = await fetch('https://api.belscope.be/v1/companies/0400378485/address', {
headers: { Authorization: 'Bearer YOUR_KEY' },
});
const data = await response.json();
import requests
response = requests.get(
'https://api.belscope.be/v1/companies/0400378485/address',
headers={'Authorization': 'Bearer YOUR_KEY'},
)
data = response.json()
$context = stream_context_create([
'http' => ['header' => 'Authorization: Bearer YOUR_KEY', 'ignore_errors' => true],
]);
$response = file_get_contents('https://api.belscope.be/v1/companies/0400378485/address', false, $context);
$data = json_decode($response, true);
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("Authorization", "Bearer YOUR_KEY");
var response = await client.GetAsync("https://api.belscope.be/v1/companies/0400378485/address");
var data = await response.Content.ReadAsStringAsync();

Answer

Counts as 1 requestJSON
{
"enterprise_number": "0123.456.749",
"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
}
}
Fields 10What every field in the answer means
FieldTypeDescriptionNullable
enterprise_numbertextThe enterprise number, always as 0123.456.749.
addressblockThe registered address.Null for a sole trader.
fulltextThe whole address on one line, ready to show. The country is only added abroad.Null when the address is not known.
streettextThe street.Null when it is not known.
house_numbertextThe house number.Null when there is none.
boxtextThe box number.Null when there is none.
postal_codetextThe postal code.Null when it is not known.
municipalitytextThe municipality.Null when it is not given.
countrytextBelgië in Belgium, otherwise the country.Null when it is not known.
struck_off_datedateThe day the address was officially struck off.Null when not struck off.