API.DATA.BE

Data.be is the first api provider for Belgian Business Information.
Get company information through our simple REST API.

Request your API Key »

VAT Validity

Validate VAT user input and get back a well formatted Belgian VAT number.

View details »

Company Status

Is this company still active? Get instant validation to detect closed businesses.

View details »

Company Info

Retrieve all the company information with one simple request!

View details »

Method URL

https://api.data.be/1.0/vat/{vat_number}/validity 

Parameters

Name Type Description
vat_number string The VAT number to validate. The service will try to clean user input as much as possible to ensure validation against bad formatted VAT numbers.
The input should at least contain the 9 significant digits of a Belgian VAT number.

Response

Name Type Description
input string The VAT number requested
valid boolean true if the VAT number is a valid Belgian VAT number, false otherwise
vat-clean string The numeric part of the VAT number requested
vat-formatted string The formatted VAT number as BE 0###.###.###

Example

https://api.data.be/1.0/vat/844044609/validity
https://api.data.be/1.0/vat/0844.044.609/validity
https://api.data.be/1.0/vat/BE-0844-044-609/validity
These requests will return:
{
    "input" : "844.044.609",
    "valid" : true,
    "vat-clean" : "0844044609",
    "vat-formatted":"BE 0844.044.609"
}

Method URL

https://api.data.be/1.0/vat/{vat_number}/status 

Parameters

Name Type Description
vat_number string The VAT number to retrieve status from. The service will check the current company status (active/inactive).
The input should at least contain the 9 significant digits of a Belgian VAT number.

Response

Name Type Description
input string The VAT number requested
valid boolean true if the VAT number is a valid Belgian VAT number, false otherwise
active boolean true if the VAT number is an active Belgian company, false otherwise
vat-clean string The numeric part of the VAT number requested
vat-formatted string The formatted VAT number as BE 0###.###.###

Example

https://api.data.be/1.0/vat/844044609/status
https://api.data.be/1.0/vat/0844.044.609/status
https://api.data.be/1.0/vat/BE-0844-044-609/status
These requests will return:
{
    "input" : "844.044.609",
    "valid" : true,
    "active" : true,
    "vat-clean" : "0844044609",
    "vat-formatted":"BE 0844.044.609"
}

Method URL

https://api.data.be/1.0/vat/{vat_number}/basic 

Parameters

Name Type Description
vat_number string The VAT number to retrieve basic information from. The service will return basic company information for the specified VAT number.
The input should at least contain the 9 significant digits of a Belgian VAT number.

Response

Name Type Description
input string The VAT number requested
valid boolean true if the VAT number is a valid Belgian VAT number, false otherwise
company-name string The company name
start-date date The company establishment date
active boolean true if the VAT number is an active Belgian company, false otherwise
language string Company language as 2-letter code (en, nl, fr, de)
address-fr string Company full address in French
address-nl string Company full address in Dutch
vat-clean string The numeric part of the VAT number requested
vat-formatted string The formatted VAT number as BE 0###.###.###

Example

https://api.data.be/1.0/vat/844044609/basic
https://api.data.be/1.0/vat/0844.044.609/basic
https://api.data.be/1.0/vat/BE-0844-044-609/basic
These requests will return:
{
    "input" : "844.044.609",
    "valid" : true,
    "company-name" : "Data.be",
    "start-date" : "2012-02-29",
    "active":true,
    "language":"fr",
    "address-fr" : "Rue des Pères Blancs 4, 1040 Etterbeek",
    "address-nl" : "Witte Patersstraat 4, 1040 Etterbeek",
    "vat-clean" : "0844044609",
    "vat-formatted":"BE 0844.044.609"
}

Method URL

https://api.data.be/1.0/search/geo 

Query Parameters

Name Type Description
lat number Required: latitude value to use for the search.
The input should use '.' as the decimal separator.
lng number Required: longitude value to use for the search.
The input should use '.' as the decimal separator.
dist number Optional: distance value in meter to use for the search.
The default value used is 1000 m.
max number Optional: maximum number of companies to return.
The default value used is 10 and the maximum value is 50.

Response

Name Type Description
latitude number The latitude value requested
longitude number The longitude value requested
distance number The distance value requested
companies array List of companies located next to the coordinates provided.
The maximum results returned is 50.
Name Type Description
company-name string The company name
start-date date The company establishment date
active boolean true if the VAT number is an active Belgian company, false otherwise
language string Company language as 2-letter code (en, nl, fr, de)
address-fr string Company full address in French
address-nl string Company full address in Dutch
latitude number The latitude of the company's address
longitude number The longitude of the company's address
distance number The distance in meter from the search input values (latitude, longitude)
vat-formatted string The formatted VAT number as BE 0###.###.###

Example

https://api.data.be/1.0/search/geo?lat=50.826808&lng=4.400287&dist=10&max=1
These requests will return:
{
    latitude: "50.826808",
    longitude: "4.400287",
    distance: "10",
    count: 1,
    companies: [
        {
            "company-name": "Data.be",
            "start-date": "2012-02-29",
            "active": true,
            "language": "fr",
            "address-fr": "Rue des Pères Blancs 4, , 1040 Etterbeek",
            "address-nl": "Witte Patersstraat 4, , 1040 Etterbeek",
            "latitude": 50.826808,
            "longitude": 4.400287,
            "distance" : 0,
            "vat-formatted": "BE 0844.044.609"
        }
    ]
}

Method URL

https://api.data.be/1.0/vies/vat/{vat_number}/validity 

Parameters

Name Type Description
vat_number string The European VAT number to validate. The service will try to clean user input as much as possible to ensure validation against bad formatted VAT numbers.
The input should at least contain the European country code (2-letters ISO 3166-1) and the country specific significant digits of the VAT number.

Response

Name Type Description
countryCode string The country code of the VAT number requested
vatNumber string The numeric part of the VAT number requested
requestDate date The request date
valid boolean true if the VAT number is a valid European VAT number, false otherwise
name string The company name
address string The company full address

Example

https://api.data.be/1.0/vies/vat/BE0844044609/validity
This request will return:
{
    "countryCode" : "BE",
    "vatNumber" : "0844044609",
    "requestDate" : "2012-02-29+02:00",
    "valid" : true,
    "name" : "SPRL DATA.BE",
    "address" : "RUE DES PERES BLANCS 4\n1040  ETTERBEEK"
}