Getting started

CBE API is an API that allows you to get data from the CBE public Database. The responses are given in JSON format. You will get the data for companies in the following format:

                {
  "cbe_number": "0783225610",
  "cbe_number_formatted": "0783.225.610",
  "denomination": "ACME",
  "denomination_with_legal_form": "ACME SRL",
  "address": {
    "street": "Rue des Looney Tunes",
    "street_number": "42",
    "box": "",
    "post_code": "4000",
    "city": "Liège",
    "full_address": "Rue des Looney Tunes 42 4000 Liège"
  },
  "juridical_form": "Société à responsabilité limitée",
  "juridical_form_short": "SRL",
  "juridical_form_id": 129,
  "start_date": null,
  "contact_infos": {
    "email": "info@example.com",
    "phone": "+32 123 45 67 89",
    "web": "example.com"
  }
}
            

The base uri for the v1 is https//cbeapi.be/api/v1.

Authentication

You need to authenticate yourself to use the API. You can do this by adding a token to the header of your request with the name Authorization. and the value Bearer TOKEN. The value of the token is the secret you get from the Dashboard.

Authentication example

$ curl -X GET https//cbeapi.be/api/v1/company/0783.225.610 -H 'Authorization: Bearer YOUR_TOKEN'

Endpoints

Getting a company info by CBE Number / VAT Number

By doing a GET request to /company/{cbeNumber} you can search a company by its CBE Number. The parameter cbeNumber is the CBE Number of the company you are getting the information for. The response is given in JSON format, and it will return one result.

Example : Requesting the infos for the company with number 0783.225.610

$ curl -X GET https//cbeapi.be/api/v1/company/0783.225.610 -H 'Authorization: Bearer YOUR_TOKEN'

The number should be in one of these formats: 1234567890 or BE1234567890. Points in the parameter are not a problem.

The response will look like this:

                
{
    "data" : [
        {
            "cbe_number": "0783225610",
            "cbe_number_formatted": "0783.225.610",
            "denomination": "ACME",
            "denomination_with_legal_form": "ACME SRL",
            "address": {
                "street": "Rue des Looney Tunes",
                "street_number": "42",
                "box": "",
                "post_code": "4000",
                "city": "Liège",
                "full_address": "Rue des Looney Tunes 42 4000 Liège"
            },
            "juridical_form": "Société à responsabilité limitée",
            "juridical_form_short": "SRL",
            "juridical_form_id": 129,
            "start_date": null,
            "contact_infos": {
                "email": "info@example.com",
                "phone": "+32 123 45 67 89",
                "web": "example.com"
            }
        }
    ]
}
                
            

Searching a company by its name

By doing a GET request to /company/search/?name={SEARCHED_NAME} you can search a company by its name.

$ curl -X GET https//cbeapi.be/api/v1/company/search?name=SEARCHED_NAME -H 'Authorization: Bearer YOUR_TOKEN'

The parameter SEARCHED_NAME is the name of the company you are searching for. The response is given in JSON format.