COMPANYAPI

Look up a company by number.

GET /companies/{number} returns available basic company information.

Request

Required path parameter: number. Accepts a checksum-valid ten-digit enterprise number, including dotted or BE-prefixed input. Authentication: X-Api-Key.

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

Response

200 returns one company object with enterpriseNumber, vatNumber, name, status, juridicalSituation, typeOfEnterprise, juridicalForm, juridicalFormCAC and startDate. Basic lookup does not return addresses.

Status and limits

400: malformed or invalid checksum. 401: authentication failure. 404: no available company. 429: rate limit reached. Client rate limits apply. A deleted record is excluded; an inactive company may still be returned.

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.