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 --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 '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
{
"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.
