Documentation / Search

API BCE address search: find Belgian companies by address

API BCE address search: find the Belgian companies registered at an address (postal code, street, number), with paginated results and their status.

Endpoints for the Search resource. All calls require authentication and return the standard JSON envelope.

🔗

Base URL: https://companybelgium.be/api/v2 · Authentication

Search enterprises by postal address#

GET/search/address

Find enterprises registered at a given Belgian address. Street is matched partially (FR or NL); results are paginated.

Parameters

NameIn/TypeRequiredDescription
postalCodequery stringRequired4-digit Belgian postal code, e.g. 1000.
streetquery stringRequiredStreet name (partial match, FR or NL).
houseNumberquery stringoptionalExact house number.
pagequery integeroptional1-based page number (20 results per page).
pageSizequery integeroptionalResults per page (default 20, max 100). Alias: limit.

Request

curl https://companybelgium.be/api/v2/search/address \
  -H "X-API-Key: $API_BCE_KEY" \
  -H "X-API-Secret: $API_BCE_SECRET"

Response

{
  "success": true,
  "data": {
    "results": [
      {
        "enterpriseNumber": "1033.022.383",
        "name": "ESPERO-SOFT INFORMATIQUES",
        "status": "AC",
        "statusCode": "AC",
        "juridicalSituationCode": "...",
        "type": "PM",
        "address": "Rue de la Colonne 1A, 1080 Molenbeek-Saint-Jean",
        "startDate": "..."
      }
    ],
    "totalResults": "...",
    "currentPage": 1,
    "totalPages": "...",
    "searchParams": {
      "zipCode": "1080"
    }
  },
  "timestamp": "...",
  "meta": {
    "responseTime": "..."
  }
}
â–¶ Try this request

Demo requests go through api-bce.be with a shared key: 15 requests every 10 minutes, public register data only.

GET /search/address
cURL
curl "" \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

Address search use cases for API BCE#

Sometimes you know where a company is, but not its number. The address search fills that gap. It finds the enterprises registered at a given Belgian address and returns their numbers, names and status.

  • KYB checks: spot an unusual number of enterprises registered at the same address.
  • Field prospecting: list the companies registered on a street before a sales visit.
  • Property management: identify the companies registered in a building you manage.
  • Data cleaning: recover the enterprise number of a CRM account that only has an address.

Because each result also includes juridicalSituationCode, you can apply a first risk filter at the same time. Then, load full records only for the companies that matter.

Building precise queries#

Two parameters are required: postalCode, with 4 digits, and street. The street is matched partially, in French or in Dutch, which helps in bilingual municipalities. However, a short fragment returns many rows. Therefore, start with the full street name, then add houseNumber for an exact match. In addition, trim user input and URL-encode it before you send it.

Handling paginated results with API BCE#

Results are paginated with page and pageSize. By default, a page holds 20 results, and pageSize goes up to 100. The response also returns totalResults, currentPage and totalPages, so you know when to stop. Moreover, searchParams echoes your query, which helps when you debug.

Each result carries status and statusCode. As a result, you can filter active enterprises in your own code. Remember also that each page is a separate request, so fetch only the pages a user actually opens.

Address data in a CRM is often messy. Before a query, split the address into postal code, street and number, because the route takes them as separate parameters. Then, remove the house number from the street field, and drop box details. In addition, when a first query returns nothing, retry with a shorter street fragment, such as the main word of the street name. As a result, more lookups succeed without manual work. Finally, keep the matched enterpriseNumber in your CRM, so the next lookup is direct.

API BCE address search FAQ#

Can I search without a postal code?

No. Both postalCode and street are required. Instead, use /denominations when you only know the name.

Does the street have to be in French?

No. The street is matched partially in French or in Dutch, so either form works.

How do I keep only active companies?

Each result includes status and statusCode. So, filter on these fields in your code after each page.