COMPANYAPI

Your first CompanyAPI request.

From client onboarding to structured Belgian company data.

1. Create a workspace and a key

Complete client onboarding, choose your subscription, verify your email and create an API key in the workspace. Store the key securely; the secret is shown when it is created.

2. Make a server-side request

Set COMPANYAPI_KEY in your server environment. Search by name with the X-Api-Key header. This cURL example returns an array of possible matches.

cURL
curl --get 'https://api.companyapi.be/companies' \
  --data-urlencode 'name=Colruyt' \
  --data-urlencode 'limit=5' \
  --header "X-Api-Key: $COMPANYAPI_KEY"

3. Retrieve the details

Select the enterprise number you need and request its extended record for available addresses, contacts and activities. A basic lookup returns identity and legal-status information.

cURL
curl 'https://api.companyapi.be/companies/0801523965/extended' \
  --header "X-Api-Key: $COMPANYAPI_KEY"

4. Handle real-world responses

Distinguish a 400 input error from 401 authentication, 404 no match and 429 throttling. Do not expose your key to a browser or log sensitive request details.

Illustrative response

JSON
{
  "enterpriseNumber": "0801.523.965",
  "vatNumber": "BE0801.523.965",
  "name": "Nyffels",
  "status": { "code": "AC", "descriptions": {} },
  "juridicalSituation": { "code": "000", "descriptions": {} },
  "typeOfEnterprise": { "code": "2", "descriptions": {} },
  "juridicalForm": null,
  "juridicalFormCAC": null,
  "startDate": "2023-05-01"
}

Sample data, not a live lookup. Dates and field values are illustrative.

Documentation

COMPANYAPI

Build your next connection.

Start with a free API key. Give your application a better foundation.

Get an API key

We save your privacy choice. With your permission, we remember your language, measure visits with Umami, and record interactions for session replays and heatmaps. Each optional purpose is off until you choose.

No advertising trackers. Change or withdraw your choices at any time using Cookie preferences.