Search Establishments

Search for Belgian establishments (unités d'établissement) by name, postal code, or city. At least one search criteria is required. Returns detailed information about matching establishments.

GET

/api/establishments/search

Headers

Header	Value	Description
`X-API-Key`	`pk_live_...`	Your API public key
`X-API-Secret`	`sk_live_...`	Your API secret key (optional for public access)

Paramètres

Name	Type	Description
`name` optionnel	`string`	Establishment name or keyword to search forExemple: `Delhaize`
`zipCode` optionnel	`string`	Postal code of the establishmentExemple: `1000`
`city` optionnel	`string`	City name where the establishment is locatedExemple: `Bruxelles`
`page` optionnel	`integer`	Page number for paginationExemple: `1`Défaut: `1`

Exemple de requête

cURL

curl -X GET \
  "https://companybelgium.be/api/establishments/search?name=Delhaize&zipCode=1000" \
  -H "X-API-Key: pk_live_votre_cle"

JavaScript / Node.js

const response = await fetch(
  'https://companybelgium.be/api/establishments/search?name=Delhaize&zipCode=1000',
  {
    headers: {
      'X-API-Key': process.env.API_KEY,
    },
  }
);

const data = await response.json();

if (data.success) {
  console.log(`${data.data.totalResults} establishments found`);
  data.data.results.forEach(est => {
    console.log(`${est.name} - ${est.establishmentNumber}`);
    console.log(`Address: ${est.address}`);
  });
}

Python

import requests

response = requests.get(
    'https://companybelgium.be/api/establishments/search',
    params={'name': 'Delhaize', 'zipCode': '1000'},
    headers={'X-API-Key': 'pk_live_votre_cle'}
)
data = response.json()

if data['success']:
    print(f"{data['data']['totalResults']} establishments found")
    for est in data['data']['results']:
        print(f"{est['name']} - {est['establishmentNumber']}")
        print(f"Address: {est['address']}")

Exemple de réponse

200 OK

{
  "success": true,
  "data": {
    "results": [
      {
        "establishmentNumber": "2.123.456.789",
        "enterpriseNumber": "0402.206.045",
        "name": "Delhaize Bruxelles Centre",
        "address": "Rue Neuve 123, 1000 Bruxelles",
        "zipCode": "1000",
        "city": "Bruxelles",
        "startDate": "15/03/2005",
        "activities": [
          {
            "naceCode": "47.11",
            "classification": "BE 2008",
            "description": "Commerce de détail en magasin non spécialisé à prédominance alimentaire"
          }
        ]
      }
    ],
    "totalResults": 15,
    "currentPage": 1,
    "totalPages": 2,
    "searchParams": {
      "name": "Delhaize",
      "zipCode": "1000"
    }
  },
  "timestamp": "2026-04-03T10:30:00.000Z"
}

Page précédente

Détails d'une entreprise

Page suivante

Détails d'un établissement

Besoin d'aide ?

Notre equipe de support est disponible pour vous aider avec l'integration de l'API.