COMPANYAPI

Search company names.

GET /companies?name={name}&limit={limit} returns possible matches.

Query parameters

name is required: at least 3 characters after trimming. limit is optional: default 20, minimum 1, maximum 100. Fuzzy matching returns candidates; it does not prove identity. Authentication: X-Api-Key.

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

Response

200 returns an array of basic company objects. No matches produces an empty array, not 404. Names come from available, non-deleted denominations. Select the correct enterprise number before requesting extended details.

Status and limits

400: missing/short name or limit outside 1–100. 401: authentication failure. 429: rate limit reached. Plan limits apply to the request, not the number of returned matches.

Basic company information

FieldMeaningAvailability
enterpriseNumberCompany enterprise number, as stored in the registry snapshot.Present
vatNumberBE-prefixed enterprise number; not a VAT validity check.Can be null
nameSelected company denomination.Can be null
statusRegistry status code and available descriptions.Present
juridicalSituationLegal situation code and available descriptions.Present
typeOfEnterpriseType of enterprise.Present
juridicalFormLegal form.Can be null
juridicalFormCACLegal form under the Companies and Associations Code.Can be null
startDateRegistry start date.Present

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.

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.