Profile

General	Name, company or sole trader, legal form, legal situation and start date.
Address	The registered address. Empty for a sole trader.
Contacts	Email addresses, phone numbers and websites.
Activities	The main and secondary activity codes, with what they mean.

Request

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

curl

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

Node.js

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

Python

import requests

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

Answer

Counts as 1 requestJSON

{
  "enterprise_number": "0123.456.749",
  "general": {
    "name": "Belscope",
    "entity_type": "Rechtspersoon",
    "legal_form": "Besloten Vennootschap",
    "legal_situation": "Normale toestand",
    "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": [
      "info@belscope.be"
    ],
    "phones": [
      "09 123 45 67"
    ],
    "websites": [
      "www.belscope.be"
    ]
  },
  "activities": {
    "main": [
      {
        "code": "62100",
        "description": "Ontwerpen van computerprogramma’s"
      },
      {
        "code": "63100",
        "description": "Computerinfrastructuur, gegevensverwerking, hosting en aanverwante activiteiten"
      }
    ],
    "secondary": [
      {
        "code": "58290",
        "description": "Uitgeven van overige software"
      },
      {
        "code": "62200",
        "description": "Activiteiten op het gebied van computerconsultancy en beheer van computerfaciliteiten"
      },
      {
        "code": "62900",
        "description": "Overige diensten op het gebied van informatietechnologie en computer"
      }
    ]
  }
}

Fields 25What every field in the answer means

Field	Type	Description	Nullable
enterprise_number	text	The enterprise number, always as 0123.456.749.
general	block	Who the company is.
name	text	The official name.
entity_type	text	Rechtspersoon for a company, Natuurlijk Persoon for a sole trader.
legal_form	text	The legal form, such as Besloten Vennootschap.	Null for a sole trader.
legal_situation	text	The current legal state, such as Normale toestand, or a dissolution or bankruptcy.
start_date	date	The day the company started.	Null when it is not known.
address	block	The registered address.	Null for a sole trader.
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 company.
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 the company does, as activity codes (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.
description	text	What the code means.