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

Search companies

Find every company that matches what you are looking for, for example all construction companies with at least 10 employees.

TotalHow many companies match.
CompaniesThe profile of every company that matches all your filters. Sole traders are not included.
Next pageWhere to continue when there are more than fit on one page (up to 100 per page).

Fill in what you are looking for. The request builds itself below; copy it into your software.

Activityactivity
    Joint committeejoint_committee
      Size in FTEmin_fte, max_fte
      Legal formlegal_form
        Legal situationlegal_situation
          Age in yearsmin_age, max_age
          GEThttps://api.belscope.be/v1/companies

          Answer

          Counts as 1 request per companyJSON
          {
          "total": 1284,
          "results": [
          {
          "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"
          }
          ]
          }
          }
          ],
          "next": "eyJhZnRlciI6IjAxMjM0NTY3NDkifQ"
          }
          Filters 11What every filter means
          ParameterTypeDescription
          activitylistWhat the company does, as an activity code of NACE-BEL 2025 (older NACE 2008 codes find nothing). A short code covers everything under it: 62 finds every IT company (62100, 62900 and so on). Several codes: separate them with commas. Example: 62,631
          activity_typetextmain: only the company's main activities count. all: its secondary activities count too. Default: main. Example: all
          joint_committeelistThe joint committee (paritair comité) number, such as 200 or 149.01. 149 does not include 149.01: to get both, ask for 149,149.01. Example: 200,124
          min_ftenumberAt least this many employees, in full-time equivalents. Companies whose number is not known are left out. Example: 10
          max_ftenumberAt most this many employees, in full-time equivalents. Companies whose number is not known are left out. Example: 50
          legal_formlistThe legal form, as its code, such as 610 for a BV. Example: 610,014
          legal_situationlistThe legal situation, as its code. 000 means active as normal: not dissolved, not bankrupt. Example: 000
          min_agenumberAt least this many years old, counted in full years since the start date, like a person's age. Companies without a known start date are left out. Example: 1
          max_agenumberAt most this many years old, in full years: 0 is less than 1 year old, so max_age=0 finds the companies that started in the last 12 months. Example: 2
          limitnumberHow many companies per page, from 1 to 100. Every company in the answer counts as 1 request. Default: 100. Example: 50
          nexttextFor the next page: take next from the answer and send the same request again with it. Example: eyJhZnRlciI6IjAxMjMuNDU2Ljc0OSJ9