Wij kunnen de website tonen in een taal die waarschijnlijk meer overeenkomt met uw taal instellingen
We can display the website in a language that is more likely to match your language settings
Nous pouvons afficher le site dans une langue qui est plus susceptible de correspondre à vos paramètres linguistiques
Wir können die Website in einer Sprache anzeigen, die eher geeignet ist für Ihre Spracheinstellungen.

API documentation

2.7

Intro

Our JSON REST-API is easy to integrate and contains a logical structure of the methods.

What's an API?

An Application Programming Interface (API) is a computing interface which defines interactions between multiple software intermediaries. It defines the kinds of calls or requests that can be made, how to make them, the data formats that should be used, the conventions to follow, without developers having to know how the other software exactly works.

What's an REST API?

Representational State Transfer (for short REST) is a software architectural style that defines a set of constraints to be used for creating Web services. SOAP has been replaced with URLs for addressing and the HTTP methods (GET, POST, DELETE and PUT) for calling the service.

Any programming language currently applicable to dynamically handle HTTP requests, in example with a cURL-library, is suitable for using REST.

Requests

API-token

To make requests to the API-endpoints, you will need an API-token. For development purposes, you can use a sandbox-token, read more about it in the sandbox-section.

You may create multiple production token, this can be useful if you would like to use the same subscription on different websites. You can make distinction between multiple websites or apps and the total number of requests.

You may create API-tokens for both sandbox- and production requests at your customer portal.

Authorization

You authorize the request by using a Bearer-token (your API-key) in the Authorization-header.

200 Success response

The provided authorization token is valid.
  • Field
    Type
    Description
  • Customer
    object
  • name
    string
    The username of the authorized customer
    Example: My Company Ltd.
  • planName
    string
    Active plan name This field is deprecated, use the Plan.name field instead.
    Example: Small
  • dateCreated
    string
    The date the customer is created
    Example: 2020-02-02 02:02:02
  • webhookSubscriptionUsage
    number
    The current webhook subscription usage.
    Example: 300
  • requestUsage
    number
    The current request usage.
    Example: 7800
  • requestSearchUsage
    number
    The current search request usage.
    Example: 2400
  • Plan
    object
    The currently active plan of the customer
  • name
    string
    The customer active plan name
    Example: Small
  • maxRequest
    number
    The maximum allowed request usage
    Example: 1500
  • maxRequestSearch
    number
    The maximum allowed search request usage
    Example: 500
  • maxWebhookSubscriptions
    number
    The maximum allowed webhook subscriptions
    Example: 400
  • maxPagination
    number
    The maximum results that will be returned for a paginated request
    Example: 25
  • ApiAccessToken
    object
  • isSandbox
    boolean
    API-token type
  • description
    string
    The customer defined description of the token
    Example: My custom token
  • dateCreated
    string
    Example: 2020-02-02 02:02:02
  • dateExpiration
    string
    Example: 2021-02-02 02:02:02 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/me
{
    "Customer": {
        "name": "My Company Ltd.",
        "planName": "Small",
        "dateCreated": "2020-02-02 02:02:02",
        "webhookSubscriptionUsage": 300,
        "requestUsage": 7800,
        "requestSearchUsage": 2400,
        "Plan": {
            "name": "Small",
            "maxRequest": 1500,
            "maxRequestSearch": 500,
            "maxWebhookSubscriptions": 400,
            "maxPagination": 25
        }
    },
    "ApiAccessToken": {
        "isSandbox": false,
        "description": "My custom token",
        "dateCreated": "2020-02-02 02:02:02",
        "dateExpiration": "2021-02-02 02:02:02"
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

Pagination

Some methods return more than one result and are paginated over multiple pages. These requests will always include a Pagination-object. The maximum number of results per request depend on the purchased plan.

Response

  • Field
    Type
    Description
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
  • page
    integer
    The current page
  • totalPages
    integer
    The number of pages
  • totalItems
    integer
    The total number of items in the source data
  • countItems
    integer
    The number of items in the current request
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.

Headers

A number of API-related headers are included in the response headers of the request. They are useful to determine how many requests you have left for the current period and what type of key you're currently using.

Example (headers)

Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

Description

The headers below are displayed in a request. Some values may depend on the type of key used (sandbox- or production key).

  • Header
    Type
    Description
  • X-Environment
    string
    The type of environment request. Can be either `sandbox` or `production`.
  • X-API-Request-Cost
    integer
    The request cost for this endpoint
  • X-API-Request-Count
    integer
    The request count usage of the current period, excluding the current request.
  • X-API-Request-Limit
    integer
    The maximum allowed requests per period.
  • X-API-Search-Request-Cost
    integer
    The search request cost for this endpoint
  • X-API-Search-Request-Count
    integer
    The maximum allowed search requests per period.
  • X-API-Search-Request-Limit
    integer
    The request search count usage of the current period, excluding the current request.

This details serves as an aid, and can also be seen visually on your dashboard.

Endpoints

For the production environment use the following url with all endpoints. Please note that an active subscription and API-key is required:

GET https://api.kbodata.app/v2/

You may also use a different environments if you wish to mock or test API-requests. Please find more information about our sandbox environment in the sandbox section on the page.

This is a list of all currently available environments:

  • Domain name
    Environment
    Description
  • https://api.kbodata.app/v2/
    production
    KBO API (production key)
  • https://api.kbodata.io/v2/
    sandbox
    KBO Sandbox API (sandbox key)

Arguments prefixed with a (asterisk) are required, without these arguments the request will fail. Other arguments are optional.

To not publish any (old or incorrect) enterprise data on our website, we use fictional data in our examples.

Before you start with the implementation of our API, it is useful to have a clear picture of the data structure, below you fill find an image of the hierarchy of data and how they relate to each other.

API structure

As you can see, a denomination, address and activity can be related to both an enterprise or an establishment. Unfortunately, there are not any fixed rules for this structure. So in example it will be possible that an enterprise does not have any registration addresses, however the establishment linked to the enterprise does. Vice versa is also possible. Therefore, it is always a good idea to check the establishments of the enterprises if you are looking for any specific data.

Endpoints overview

Enterprises

/enterprise/{enterpriseNumber}

Retrieve enterprise details.
Retrieve the enterprise details by the enterprise number.

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106

Parameters Query

  • Field
    Type
    Description
  • include Medium plan or up
    array
    Include additional relation datasets in the response. Each included relation counts as one additional request towards your usage. The total cost of the request is returned in the X-Api-Request-Cost response header. Note that Contacts, EnterpriseFinancial and EnterpriseRoles inclusion depends on your subscription plan.
    Possible values: Address Denominations Activities Contacts EnterpriseFinancial EnterpriseRoles
    Example: Denominations

Example

200 Successful response

Enterprise is found.
  • Field
    Type
    Description
  • Enterprise
    object
  • enterpriseNumber
    string
    The enterprise number as digits only.
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    The enterprise number as formatted human readable string.
    Example: 0417.497.106
  • vatNumber
    string
    VAT number
    Example: BE0417497106
  • active
    boolean
    Whether the registration status of the enterprise is active or inactive. This field will also be false if the enterprise is in a pre-registration state.
    Example: 1
  • type
    string
    The company type, natural for natural person or entity for legal entity.
    Possible values: natural entity
    Example: entity
  • typeDescription
    object
  • nl
    string
    Dutch description
    Example: Rechtspersoon
  • en
    string
    English description
    Example: Legal entity
  • fr
    string
    French description
    Example: Personne morale
  • de
    string
    German description
    Example: Juristische Person
  • JuridicalForm
    object
  • juridicalFormCode
    string
    Juridical Form code
    Example: 030
  • description
    object
  • nl
    string
    Dutch description of the juridical form
    Example: Buitenlandse entiteit
  • en
    string
    English description of the juridical form
    Example: Foreign entity
  • fr
    string
    French description of the juridical form
    Example: Entité étrangère
  • de
    string
    German description of the juridical form
    Example: Ausländische Einheit
  • abbreviation
    object
  • nl
    string
    Dutch abbreviation of the juridical form
    Example: Buitenlandse entiteit
  • en
    string
    English abbreviation of the juridical form
    Example: Foreign entity
  • fr
    string
    French abbreviation of the juridical form
    Example: Entité étrangère
  • de
    string
    German abbreviation of the juridical form
    Example: Ausländische Einheit
  • JuridicalSituation
    object
  • juridicalSituationCode
    string
    Juridical Situation code
    Example: 000
  • description
    object
  • nl
    string
    Dutch description of the juridical situation
    Example: Normale toestand
  • en
    string
    English description of the juridical situation
    Example: Foreign entity
  • fr
    string
    French description of the juridical situation
    Example: Situation normale
  • de
    string
    German description of the juridical situation
    Example: Gewöhnlicher Zustand
  • dateStart
    string
    Example: 2020-01-01
  • dateEnd
    stringnull
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname
  • matched
    boolean
    Whether this denomination matched the search query. Only present when the param Denomination.includeMatch is set to true and the denomination matched.
    Example: 1
  • score
    number
    Relevance score of this denomination match. Only present when the param Denomination.includeScore is set to true and the denomination matched.
    Example: 1.23
  • Activity
    object
  • activityGroup
    string
    Possible values: BTW001 EDR001 OLK001 POR001 PPO001 RSZ001 SCO001
    Example: BTW001
  • activityGroupDescription
    object
  • nl
    string
    Dutch description
    Example: BTW-activiteiten
  • fr
    string
    French description
    Example: Activités TVA
  • en
    string
    English description
    Example: VAT activities
  • de
    string
    German description
    Example: MwSt.-Aktivitäten
  • classification
    string
    Possible values: ANCI MAIN SECO
    Example: MAIN
  • classificationDescription
    object
  • nl
    string
    Dutch description
    Example: Hoofdactiviteit
  • fr
    string
    French description
    Example: Activité principale
  • en
    string
    English description
    Example: Main activity
  • de
    string
    German description
    Example: Hauptaktivität
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores
  • Contact
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • typeCode
    string
    The type of contact information
    Possible values: phone email website
    Example: phone
  • value
    string
    The value of the contact type, could be a phone number, email adress or website, depending on the typeCode.
    Example: 0032123456789
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • capitalValue
    integer
    Placed capital according to statutes
    Example: 100000
  • capitalValuta
    string
    The valuta of the placed capital, while EUR is the most common, this value can be any ISO-4217 code. It's also common for companies founded before the introduction of the Euro to have historical valuta, in example: BEF, FRF and NLG. Most foreign companies have foreign valuta present. Please visit wikipedia for an up-to-date ISO-4217 list of: - Active currency codes - Historic currency codes
    Example: EUR
  • annualAssembly
    integer
    The month of the annual assembly, range is 1 to 12.
    Example: 6
  • annualAssemblyMonth
    string
    Textual presentation in English of the annual assembly.
    Example: June
  • fiscalEnd
    string
    The end date of a regular fiscal year. The year is not present here and will be formatted as 0000.
    Example: 0000-12-21
  • fiscalSpecialStart
    string
    The start date of an exceptional fiscal year.
    Example: 2021-03-01
  • fiscalSpecialEnd
    string
    The end date of an exceptional fiscal year.
    Example: 2022-02-28
  • EnterpriseRole
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • nameFirst
    string
    First name of the board member
    Example: Frans
  • nameLast
    string
    Last name of the board member
    Example: Vanderbeek
  • parentEnterpriseNumber
    string
    The enterprise number of which the role is inherited from. If the nameLast and nameFirst fields are both empty, the legal entity of the parent enterprise fulfills this role.
    Example: 0417497105
  • parentEnterpriseNumberFormatted
    string
    The enterprise number formatted.
    Example: 0417.497.106
  • dateInOffice
    string
    The date the person was registered
    Example: 2021-01-01
  • Role
    object
  • roleCode
    integer
    Code of the function title. Please be aware that this code may change at anytime, so it's advisable not to put to much reference to this value. Or to check periodicly for any changes.
    Example: 5
  • title
    object
  • nl
    string
    Function title in Dutch
    Example: Zaakvoerder
  • en
    string
    Function title in English
    Example: Manager
  • fr
    string
    Function title in French
    Example: Gérant
  • de
    string
    Function title in German
    Example: Geschäftsführer
  • note
    object
    Possible note regarding function title
  • nl
    string
    Possible note regarding function title in Dutch
    Example: Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term "Zaakvoerder" vanaf 1 januari 2020 gelezen worden als "Bestuurder"
  • en
    string
    Possible note regarding the function title in English
    Example: Pursuant to the Code of Companies and Associations, the term "Manager" must, since January 1, 2020, be read as "Board member".
  • fr
    string
    Possible note regarding function title in French
    Example: En application du Code des sociétés et des associations, le terme "Gérant" doit, depuis le 1er janvier 2020, être lu comme étant "Administrateur".
  • de
    string
    Possible note regarding function title in German
    Example: Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff "Geschäftsführer" seit dem 1. Januar 2020 als "Verwalter" zu lesen. 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}
{
    "Enterprise": {
        "enterpriseNumber": "0417497106",
        "enterpriseNumberFormatted": "0417.497.106",
        "vatNumber": "BE0417497106",
        "active": true,
        "type": "entity",
        "typeDescription": {
            "nl": "Rechtspersoon",
            "en": "Legal entity",
            "fr": "Personne morale",
            "de": "Juristische Person"
        },
        "JuridicalForm": {
            "juridicalFormCode": "030",
            "description": {
                "nl": "Buitenlandse entiteit",
                "en": "Foreign entity",
                "fr": "Entité étrangère",
                "de": "Ausländische Einheit"
            },
            "abbreviation": {
                "nl": "Buitenlandse entiteit",
                "en": "Foreign entity",
                "fr": "Entité étrangère",
                "de": "Ausländische Einheit"
            }
        },
        "JuridicalSituation": {
            "juridicalSituationCode": "000",
            "description": {
                "nl": "Normale toestand",
                "en": "Foreign entity",
                "fr": "Situation normale",
                "de": "Gewöhnlicher Zustand"
            }
        },
        "dateStart": "2020-01-01",
        "dateEnd": null,
        "Address": {
            "entityNumber": "0417497106",
            "entityNumberFormatted": "0417.497.106",
            "entityType": "enterprise",
            "street": {
                "nl": "Kerkstraat",
                "fr": "Rue de l'Église"
            },
            "addressNumber": 1,
            "addressAdditional": "Unit 12, Floor 5",
            "postOfficeBox": "Box 5",
            "zipcode": 2000,
            "city": {
                "nl": "Brussel",
                "fr": "Bruxelles"
            },
            "countryCode": "fr",
            "country": {
                "nl": "Frankrijk",
                "fr": "France",
                "en": "France",
                "de": "string"
            },
            "dateStart": "2020-01-01"
        },
        "Denominations": [
            {
                "Denomination": {
                    "entityNumber": "0417497106",
                    "entityNumberFormatted": "0417.497.106",
                    "entityType": "enterprise",
                    "language": "nl",
                    "value": "FaimMedia B.V.",
                    "type": "social",
                    "typeDescription": {
                        "nl": "Maatschappelijke naam",
                        "en": "Primary name",
                        "fr": "Dénomination sociale",
                        "de": "Primärname"
                    }
                },
                "matched": true,
                "score": 1
            },
            {
                "…": "…"
            }
        ],
        "Activities": [
            {
                "Activity": {
                    "activityGroup": "BTW001",
                    "activityGroupDescription": {
                        "nl": "BTW-activiteiten",
                        "fr": "Activités TVA",
                        "en": "VAT activities",
                        "de": "MwSt.-Aktivitäten"
                    },
                    "classification": "MAIN",
                    "classificationDescription": {
                        "nl": "Hoofdactiviteit",
                        "fr": "Activité principale",
                        "en": "Main activity",
                        "de": "Hauptaktivität"
                    },
                    "Nace": {
                        "naceVersion": 2008,
                        "naceCode": "474",
                        "description": {
                            "nl": "Detailhandel in ICT-apparatuur in gespecialiseerde winkels",
                            "fr": "Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé",
                            "de": "Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)",
                            "en": "Retail sale of information and communication equipment in specialised stores"
                        }
                    }
                }
            },
            {
                "…": "…"
            }
        ],
        "Contacts": [
            {
                "Contact": {
                    "enterpriseNumber": "0417497106",
                    "enterpriseNumberFormatted": "0417.497.106",
                    "typeCode": "phone",
                    "value": "0032123456789"
                }
            },
            {
                "…": "…"
            }
        ],
        "EnterpriseFinancial": {
            "enterpriseNumber": "0417497106",
            "enterpriseNumberFormatted": "0417.497.106",
            "capitalValue": 100000,
            "capitalValuta": "EUR",
            "annualAssembly": 6,
            "annualAssemblyMonth": "June",
            "fiscalEnd": "0000-12-21",
            "fiscalSpecialStart": "2021-03-01",
            "fiscalSpecialEnd": "2022-02-28"
        },
        "EnterpriseRoles": [
            {
                "EnterpriseRole": {
                    "enterpriseNumber": "0417497106",
                    "enterpriseNumberFormatted": "0417.497.106",
                    "nameFirst": "Frans",
                    "nameLast": "Vanderbeek",
                    "parentEnterpriseNumber": "0417497105",
                    "parentEnterpriseNumberFormatted": "0417.497.106",
                    "dateInOffice": "2021-01-01",
                    "Role": {
                        "roleCode": 5,
                        "title": {
                            "nl": "Zaakvoerder",
                            "en": "Manager",
                            "fr": "Gérant",
                            "de": "Geschäftsführer"
                        },
                        "note": {
                            "nl": "Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term \"Zaakvoerder\" vanaf 1 januari 2020 gelezen worden als \"Bestuurder\"\n",
                            "en": "Pursuant to the Code of Companies and Associations, the term \"Manager\" must, since January 1, 2020, be read as \"Board member\".\n",
                            "fr": "En application du Code des sociétés et des associations, le terme \"Gérant\" doit, depuis le 1er janvier 2020, être lu comme étant \"Administrateur\".\n",
                            "de": "Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff \"Geschäftsführer\" seit dem 1. Januar 2020 als \"Verwalter\" zu lesen.\n"
                        }
                    }
                }
            },
            {
                "…": "…"
            }
        ]
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Enterprise not found

The specified Enterprise number could not be found, please make sure the enterprise number is valid and correct.
{
    "error": "The `enterprise` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/enterprise/{enterpriseNumber}/activities

Retrieve all enterprise activities.
Retrieve all registered activity details by the enterprise number.

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106

Parameters Query

  • Field
    Type
    Description
  • filter.naceVersion
    integer
    Filter on a specific NACE version
    Possible values: 2008 2025

Example

200 Successful response

All activities from the enterprise.
  • Field
    Type
    Description
  • []
    array
  • Activity
    object
  • activityGroup
    string
    Possible values: BTW001 EDR001 OLK001 POR001 PPO001 RSZ001 SCO001
    Example: BTW001
  • activityGroupDescription
    object
  • nl
    string
    Dutch description
    Example: BTW-activiteiten
  • fr
    string
    French description
    Example: Activités TVA
  • en
    string
    English description
    Example: VAT activities
  • de
    string
    German description
    Example: MwSt.-Aktivitäten
  • classification
    string
    Possible values: ANCI MAIN SECO
    Example: MAIN
  • classificationDescription
    object
  • nl
    string
    Dutch description
    Example: Hoofdactiviteit
  • fr
    string
    French description
    Example: Activité principale
  • en
    string
    English description
    Example: Main activity
  • de
    string
    German description
    Example: Hauptaktivität
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}/activities
[
    {
        "Activity": {
            "activityGroup": "BTW001",
            "activityGroupDescription": {
                "nl": "BTW-activiteiten",
                "fr": "Activités TVA",
                "en": "VAT activities",
                "de": "MwSt.-Aktivitäten"
            },
            "classification": "MAIN",
            "classificationDescription": {
                "nl": "Hoofdactiviteit",
                "fr": "Activité principale",
                "en": "Main activity",
                "de": "Hauptaktivität"
            },
            "Nace": {
                "naceVersion": 2008,
                "naceCode": "474",
                "description": {
                    "nl": "Detailhandel in ICT-apparatuur in gespecialiseerde winkels",
                    "fr": "Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé",
                    "de": "Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)",
                    "en": "Retail sale of information and communication equipment in specialised stores"
                }
            }
        }
    },
    {
        "…": "…"
    }
]
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Enterprise not found

The specified Enterprise number could not be found, please make sure the enterprise number is valid and correct.
{
    "error": "The `enterprise` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/enterprise/{enterpriseNumber}/address

Retrieve a specific enterprise address by type.
Retrieve a specific address by the enterprise number and address type.

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106

Example

200 Successful response

The specific address has been found.
  • Field
    Type
    Description
  • Address
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}/address
{
    "Address": {
        "entityNumber": "0417497106",
        "entityNumberFormatted": "0417.497.106",
        "entityType": "enterprise",
        "street": {
            "nl": "Kerkstraat",
            "fr": "Rue de l'Église"
        },
        "addressNumber": 1,
        "addressAdditional": "Unit 12, Floor 5",
        "postOfficeBox": "Box 5",
        "zipcode": 2000,
        "city": {
            "nl": "Brussel",
            "fr": "Bruxelles"
        },
        "countryCode": "fr",
        "country": {
            "nl": "Frankrijk",
            "fr": "France",
            "en": "France",
            "de": "string"
        },
        "dateStart": "2020-01-01"
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Enterprise not found

The specified Enterprise number could not be found, please make sure the enterprise number is valid and correct.
{
    "error": "The `enterprise` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/enterprise/{enterpriseNumber}/contact
Large plan or up

Retrieve contact information of the enterprise.
Retrieve contact information of the enterprise (phone numbers, email addresses and websites). Please note that companies aren't required to provide these details, so not all enterprises have contact information available.

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106

Example

200 Successful response

All contact information of the enterprise.
  • Field
    Type
    Description
  • []
    array
  • Contact
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • typeCode
    string
    The type of contact information
    Possible values: phone email website
    Example: phone
  • value
    string
    The value of the contact type, could be a phone number, email adress or website, depending on the typeCode.
    Example: 0032123456789 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}/contact
[
    {
        "Contact": {
            "enterpriseNumber": "0417497106",
            "enterpriseNumberFormatted": "0417.497.106",
            "typeCode": "phone",
            "value": "0032123456789"
        }
    },
    {
        "…": "…"
    }
]
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Enterprise not found

The specified Enterprise number could not be found, please make sure the enterprise number is valid and correct.
{
    "error": "The `enterprise` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

402 Larger plan required

The endpoint (or a parameter that is present), is only accessible for a specific plan. Please verify the request which plan is required and upgrade accordingly.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "code": -31
}

/enterprise/{enterpriseNumber}/denominations

Retrieve all enterprise denominations.
Retrieve all the denominations (business names and trade names) by the enterprise number.

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106

Example

200 Successful response

All denominations from the enterprise.
  • Field
    Type
    Description
  • []
    array
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}/denominations
[
    {
        "Denomination": {
            "entityNumber": "0417497106",
            "entityNumberFormatted": "0417.497.106",
            "entityType": "enterprise",
            "language": "nl",
            "value": "FaimMedia B.V.",
            "type": "social",
            "typeDescription": {
                "nl": "Maatschappelijke naam",
                "en": "Primary name",
                "fr": "Dénomination sociale",
                "de": "Primärname"
            }
        }
    },
    {
        "…": "…"
    }
]
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Enterprise not found

The specified Enterprise number could not be found, please make sure the enterprise number is valid and correct.
{
    "error": "The `enterprise` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/enterprise/{enterpriseNumber}/denomination/{language}/{type}

Retrieve a specific enterprise denomination.
Retrieve a specific type of denomination (business names and trade names) by the enterprise number and language.

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106
  • language
    string
    The language code of the denomination. Some denominations may not have the language specified, use the unknown value in this case.
    Possible values: unknown nl en fr de
    Example: nl
  • type
    string
    The type of the denomination, see the response parameter for the type explaination.
    Possible values: social abbreviation commercial
    Example: commercial

Example

200 Successful response

The denomination has been found.
  • Field
    Type
    Description
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}/denomination/{language}/{type}
{
    "Denomination": {
        "entityNumber": "0417497106",
        "entityNumberFormatted": "0417.497.106",
        "entityType": "enterprise",
        "language": "nl",
        "value": "FaimMedia B.V.",
        "type": "social",
        "typeDescription": {
            "nl": "Maatschappelijke naam",
            "en": "Primary name",
            "fr": "Dénomination sociale",
            "de": "Primärname"
        }
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Enterprise not found

The specified Enterprise number could not be found, please make sure the enterprise number is valid and correct.
{
    "error": "The `enterprise` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/enterprise/{enterpriseNumber}/establishments

Retrieve all enterprise establishments.
Retrieve all the establishments registered for this enterprise.

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106

Parameters Query

  • Field
    Type
    Description
  • active Large plan or up
    string
    Choose if you also want to retrieve inactive establishments. The default is only active.
    Possible values: active inactive all
    Example: active

Example

200 Successful response

All establishments from the enterprise.
  • Field
    Type
    Description
  • []
    array
  • Establishment
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • establishmentNumber
    string
    The establishment number without punctuation marks.
    Example: 2102217157
  • establishmentNumberFormatted
    string
    The estblishment number seperated by punctuation marks.
    Example: 2102.217.157
  • active
    boolean
    Whether the registration status of the establishment is active or inactive. This field will also be false if the establishment is in a pre-registration state.
    Example: 1
  • dateStart
    string
    Example: 2020-01-01
  • dateEnd
    stringnull
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname
  • matched
    boolean
    Whether this denomination matched the search query. Only present when Denomination.includeMatch=true.
    Example: 1
  • score
    number
    Relevance score of this denomination match. Only present when Denomination.includeScore=true and the denomination matched.
    Example: 1.23
  • Activity
    object
  • activityGroup
    string
    Possible values: BTW001 EDR001 OLK001 POR001 PPO001 RSZ001 SCO001
    Example: BTW001
  • activityGroupDescription
    object
  • nl
    string
    Dutch description
    Example: BTW-activiteiten
  • fr
    string
    French description
    Example: Activités TVA
  • en
    string
    English description
    Example: VAT activities
  • de
    string
    German description
    Example: MwSt.-Aktivitäten
  • classification
    string
    Possible values: ANCI MAIN SECO
    Example: MAIN
  • classificationDescription
    object
  • nl
    string
    Dutch description
    Example: Hoofdactiviteit
  • fr
    string
    French description
    Example: Activité principale
  • en
    string
    English description
    Example: Main activity
  • de
    string
    German description
    Example: Hauptaktivität
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores
  • Contact
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • typeCode
    string
    The type of contact information
    Possible values: phone email website
    Example: phone
  • value
    string
    The value of the contact type, could be a phone number, email adress or website, depending on the typeCode.
    Example: 0032123456789 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}/establishments
[
    {
        "Establishment": {
            "enterpriseNumber": "0417497106",
            "enterpriseNumberFormatted": "0417.497.106",
            "establishmentNumber": "2102217157",
            "establishmentNumberFormatted": "2102.217.157",
            "active": true,
            "dateStart": "2020-01-01",
            "dateEnd": null,
            "Address": {
                "entityNumber": "0417497106",
                "entityNumberFormatted": "0417.497.106",
                "entityType": "enterprise",
                "street": {
                    "nl": "Kerkstraat",
                    "fr": "Rue de l'Église"
                },
                "addressNumber": 1,
                "addressAdditional": "Unit 12, Floor 5",
                "postOfficeBox": "Box 5",
                "zipcode": 2000,
                "city": {
                    "nl": "Brussel",
                    "fr": "Bruxelles"
                },
                "countryCode": "fr",
                "country": {
                    "nl": "Frankrijk",
                    "fr": "France",
                    "en": "France",
                    "de": "string"
                },
                "dateStart": "2020-01-01"
            },
            "Denominations": [
                {
                    "Denomination": {
                        "entityNumber": "0417497106",
                        "entityNumberFormatted": "0417.497.106",
                        "entityType": "enterprise",
                        "language": "nl",
                        "value": "FaimMedia B.V.",
                        "type": "social",
                        "typeDescription": {
                            "nl": "Maatschappelijke naam",
                            "en": "Primary name",
                            "fr": "Dénomination sociale",
                            "de": "Primärname"
                        }
                    },
                    "matched": true,
                    "score": 1
                },
                {
                    "…": "…"
                }
            ],
            "Activities": [
                {
                    "Activity": {
                        "activityGroup": "BTW001",
                        "activityGroupDescription": {
                            "nl": "BTW-activiteiten",
                            "fr": "Activités TVA",
                            "en": "VAT activities",
                            "de": "MwSt.-Aktivitäten"
                        },
                        "classification": "MAIN",
                        "classificationDescription": {
                            "nl": "Hoofdactiviteit",
                            "fr": "Activité principale",
                            "en": "Main activity",
                            "de": "Hauptaktivität"
                        },
                        "Nace": {
                            "naceVersion": 2008,
                            "naceCode": "474",
                            "description": {
                                "nl": "Detailhandel in ICT-apparatuur in gespecialiseerde winkels",
                                "fr": "Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé",
                                "de": "Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)",
                                "en": "Retail sale of information and communication equipment in specialised stores"
                            }
                        }
                    }
                },
                {
                    "…": "…"
                }
            ],
            "Contacts": [
                {
                    "Contact": {
                        "enterpriseNumber": "0417497106",
                        "enterpriseNumberFormatted": "0417.497.106",
                        "typeCode": "phone",
                        "value": "0032123456789"
                    }
                },
                {
                    "…": "…"
                }
            ]
        }
    },
    {
        "…": "…"
    }
]
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

402 Larger plan required for this parameter

The parameter you are using, is only accessible for a larger plan. Please verify the request which plan is required and upgrade your plan or omit the parameter.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "parameter": "active",
    "code": -31
}

404 Enterprise not found

The specified Enterprise number could not be found, please make sure the enterprise number is valid and correct.
{
    "error": "The `enterprise` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/enterprise/{enterpriseNumber}/financial
Large plan or up

Retrieve short financial information of the enterprise.
Retrieve short financial information of the enterprise, the following information is available:
- Paid-in capital
- Annual assembly
- Financial start and end year Please note:
- sole-proprietorships do not have published financial years, so this information will not be available
- not all enterprises are required to publicly share this information, so it will not always be available.

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106

Example

200 Successful response

Financial information from the enterprise.
  • Field
    Type
    Description
  • EnterpriseFinancial
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • capitalValue
    integer
    Placed capital according to statutes
    Example: 100000
  • capitalValuta
    string
    The valuta of the placed capital, while EUR is the most common, this value can be any ISO-4217 code. It's also common for companies founded before the introduction of the Euro to have historical valuta, in example: BEF, FRF and NLG. Most foreign companies have foreign valuta present. Please visit wikipedia for an up-to-date ISO-4217 list of: - Active currency codes - Historic currency codes
    Example: EUR
  • annualAssembly
    integer
    The month of the annual assembly, range is 1 to 12.
    Example: 6
  • annualAssemblyMonth
    string
    Textual presentation in English of the annual assembly.
    Example: June
  • fiscalEnd
    string
    The end date of a regular fiscal year. The year is not present here and will be formatted as 0000.
    Example: 0000-12-21
  • fiscalSpecialStart
    string
    The start date of an exceptional fiscal year.
    Example: 2021-03-01
  • fiscalSpecialEnd
    string
    The end date of an exceptional fiscal year.
    Example: 2022-02-28 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}/financial
{
    "EnterpriseFinancial": {
        "enterpriseNumber": "0417497106",
        "enterpriseNumberFormatted": "0417.497.106",
        "capitalValue": 100000,
        "capitalValuta": "EUR",
        "annualAssembly": 6,
        "annualAssemblyMonth": "June",
        "fiscalEnd": "0000-12-21",
        "fiscalSpecialStart": "2021-03-01",
        "fiscalSpecialEnd": "2022-02-28"
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

/enterprise/{enterpriseNumber}/nsso
New! Medium plan or up

Retrieve NSSO (RSZ, LSS, ONSS) details of the enterprise.
Retrieve NSSO details of the enterprise. Known differently per language:
- NL: Werkgeversrepertorium
- FR: Répertoire des employeurs
- DE: Verzeichnis der Arbeitgeber
- NL: RSZ-nummer
- FR: N° ONSS
- DE: LSS-Nummer
- EN: NSSO number

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106

Example

200 Successful response

NSSO information from the enterprise.
  • Field
    Type
    Description
  • EnterpriseNsso
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • nssoNumber
    integer
    The NSSO-number (or RSZ-number, LSS-number, ONSS-number) of the company
    Example: 154857201
  • nssoNumberFormatted
    string
    The formatted NSSO-number with a dash of the company
    Example: 1548572-01
  • nssoNumberProvisional
    integer
    A temporary NSSO-number that is used when no final NSSO-number has been issued.
    Example: 1234567890
  • sectors
    array
    List of sectors
  • code
    string
    Possible values: private publicFedReg publicPla
    Example: private
  • codeDescription
    object
  • nl
    string
    Example: Privé
  • fr
    string
    Example: Privé
  • de
    string
    Example: Privat
  • en
    string
    Example: Private
  • dateStart
    string
    Start date
    Example: 1706745600
  • periods
    array
    Overview of employee periods
  • dateStart
    string
    Start date of the employee period
    Example: 1709337600
  • importanceCodes
    array
  • dateStart
    string
    Start date of the employee importance code
    Example: 1712016000
  • code
    object
    Code identifier
    Possible values: 1 2 3 4 5 6 7 8 9
    Example: 1
  • codeDescription
    object
    Description of the code identifier
  • nl
    string
    Dutch description of the code identifier
    Example: 1 tot 4 werknemers
  • fr
    string
    French description of the code identifier
    Example: 1 à 4 travailleurs
  • de
    string
    German description of the code identifier
    Example: 1 bis 4 Arbeitnehmer
  • en
    string
    English description of the code identifier
    Example: 1 until 4 employees 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}/nsso
{
    "EnterpriseNsso": {
        "enterpriseNumber": "0417497106",
        "enterpriseNumberFormatted": "0417.497.106",
        "nssoNumber": 154857201,
        "nssoNumberFormatted": "1548572-01",
        "nssoNumberProvisional": 1234567890,
        "sectors": [
            {
                "code": "private",
                "codeDescription": {
                    "nl": "Privé",
                    "fr": "Privé",
                    "de": "Privat",
                    "en": "Private"
                },
                "dateStart": 1706745600
            },
            {
                "…": "…"
            }
        ],
        "periods": [
            {
                "dateStart": 1709337600,
                "importanceCodes": [
                    {
                        "dateStart": 1712016000,
                        "code": [],
                        "codeDescription": {
                            "nl": "1 tot 4 werknemers",
                            "fr": "1 à 4 travailleurs",
                            "de": "1 bis 4 Arbeitnehmer",
                            "en": "1 until 4 employees"
                        }
                    },
                    {
                        "…": "…"
                    }
                ]
            },
            {
                "…": "…"
            }
        ]
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

402 Larger plan required

The endpoint (or a parameter that is present), is only accessible for a specific plan. Please verify the request which plan is required and upgrade accordingly.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "code": -31
}

404 The provided enterprise could not be found, or does not have any NSSO information available.

503 Service unavailable, please try again later.

/enterprise/{enterpriseNumber}/roles
Large plan or up

Retrieve all official functions of the enterprise.
Retrieve all the official funtions registered for this enterprise (board of directors). Please note:
- that sole proprietorships do not have any board members, except for the natural person that legally owns the company. This will be the only present function.
- almost all foreign entities do not have any board members registered.

Parameters Path

  • Field
    Type
    Description
  • enterpriseNumber
    integer
    Number of the enterprise
    Example: 0417497106

Example

200 Successful response

All functions from the enterprise.
  • Field
    Type
    Description
  • []
    array
  • EnterpriseRole
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • nameFirst
    string
    First name of the board member
    Example: Frans
  • nameLast
    string
    Last name of the board member
    Example: Vanderbeek
  • parentEnterpriseNumber
    string
    The enterprise number of which the role is inherited from. If the nameLast and nameFirst fields are both empty, the legal entity of the parent enterprise fulfills this role.
    Example: 0417497105
  • parentEnterpriseNumberFormatted
    string
    The enterprise number formatted.
    Example: 0417.497.106
  • dateInOffice
    string
    The date the person was registered
    Example: 2021-01-01
  • Role
    object
  • roleCode
    integer
    Code of the function title. Please be aware that this code may change at anytime, so it's advisable not to put to much reference to this value. Or to check periodicly for any changes.
    Example: 5
  • title
    object
  • nl
    string
    Function title in Dutch
    Example: Zaakvoerder
  • en
    string
    Function title in English
    Example: Manager
  • fr
    string
    Function title in French
    Example: Gérant
  • de
    string
    Function title in German
    Example: Geschäftsführer
  • note
    object
    Possible note regarding function title
  • nl
    string
    Possible note regarding function title in Dutch
    Example: Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term "Zaakvoerder" vanaf 1 januari 2020 gelezen worden als "Bestuurder"
  • en
    string
    Possible note regarding the function title in English
    Example: Pursuant to the Code of Companies and Associations, the term "Manager" must, since January 1, 2020, be read as "Board member".
  • fr
    string
    Possible note regarding function title in French
    Example: En application du Code des sociétés et des associations, le terme "Gérant" doit, depuis le 1er janvier 2020, être lu comme étant "Administrateur".
  • de
    string
    Possible note regarding function title in German
    Example: Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff "Geschäftsführer" seit dem 1. Januar 2020 als "Verwalter" zu lesen. 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/enterprise/{enterpriseNumber}/roles
[
    {
        "EnterpriseRole": {
            "enterpriseNumber": "0417497106",
            "enterpriseNumberFormatted": "0417.497.106",
            "nameFirst": "Frans",
            "nameLast": "Vanderbeek",
            "parentEnterpriseNumber": "0417497105",
            "parentEnterpriseNumberFormatted": "0417.497.106",
            "dateInOffice": "2021-01-01",
            "Role": {
                "roleCode": 5,
                "title": {
                    "nl": "Zaakvoerder",
                    "en": "Manager",
                    "fr": "Gérant",
                    "de": "Geschäftsführer"
                },
                "note": {
                    "nl": "Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term \"Zaakvoerder\" vanaf 1 januari 2020 gelezen worden als \"Bestuurder\"\n",
                    "en": "Pursuant to the Code of Companies and Associations, the term \"Manager\" must, since January 1, 2020, be read as \"Board member\".\n",
                    "fr": "En application du Code des sociétés et des associations, le terme \"Gérant\" doit, depuis le 1er janvier 2020, être lu comme étant \"Administrateur\".\n",
                    "de": "Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff \"Geschäftsführer\" seit dem 1. Januar 2020 als \"Verwalter\" zu lesen.\n"
                }
            }
        }
    },
    {
        "…": "…"
    }
]
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Enterprise not found

The specified Enterprise number could not be found, please make sure the enterprise number is valid and correct.
{
    "error": "The `enterprise` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

402 Larger plan required

The endpoint (or a parameter that is present), is only accessible for a specific plan. Please verify the request which plan is required and upgrade accordingly.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "code": -31
}

Establishments

/establishment/{establishmentNumber}

Retrieve establishment details.
Retrieve the establishment details by the establishment number.

Parameters Path

  • Field
    Type
    Description
  • establishmentNumber
    integer
    Number of the establishment
    Example: 2147197839

Parameters Query

  • Field
    Type
    Description
  • include Medium plan or up
    array
    Include additional relation datasets in the response. Each included relation counts as one additional request towards your usage. The total cost of the request is returned in the X-Api-Request-Cost response header. Note that Contacts inclusion depends on your subscription plan.
    Possible values: Address Denominations Activities Contacts
    Example: Denominations

Example

200 Successful response

The establishment has been found.
  • Field
    Type
    Description
  • Establishment
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • establishmentNumber
    string
    The establishment number without punctuation marks.
    Example: 2102217157
  • establishmentNumberFormatted
    string
    The estblishment number seperated by punctuation marks.
    Example: 2102.217.157
  • active
    boolean
    Whether the registration status of the establishment is active or inactive. This field will also be false if the establishment is in a pre-registration state.
    Example: 1
  • dateStart
    string
    Example: 2020-01-01
  • dateEnd
    stringnull
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname
  • matched
    boolean
    Whether this denomination matched the search query. Only present when Denomination.includeMatch=true.
    Example: 1
  • score
    number
    Relevance score of this denomination match. Only present when Denomination.includeScore=true and the denomination matched.
    Example: 1.23
  • Activity
    object
  • activityGroup
    string
    Possible values: BTW001 EDR001 OLK001 POR001 PPO001 RSZ001 SCO001
    Example: BTW001
  • activityGroupDescription
    object
  • nl
    string
    Dutch description
    Example: BTW-activiteiten
  • fr
    string
    French description
    Example: Activités TVA
  • en
    string
    English description
    Example: VAT activities
  • de
    string
    German description
    Example: MwSt.-Aktivitäten
  • classification
    string
    Possible values: ANCI MAIN SECO
    Example: MAIN
  • classificationDescription
    object
  • nl
    string
    Dutch description
    Example: Hoofdactiviteit
  • fr
    string
    French description
    Example: Activité principale
  • en
    string
    English description
    Example: Main activity
  • de
    string
    German description
    Example: Hauptaktivität
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores
  • Contact
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • typeCode
    string
    The type of contact information
    Possible values: phone email website
    Example: phone
  • value
    string
    The value of the contact type, could be a phone number, email adress or website, depending on the typeCode.
    Example: 0032123456789 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/establishment/{establishmentNumber}
{
    "Establishment": {
        "enterpriseNumber": "0417497106",
        "enterpriseNumberFormatted": "0417.497.106",
        "establishmentNumber": "2102217157",
        "establishmentNumberFormatted": "2102.217.157",
        "active": true,
        "dateStart": "2020-01-01",
        "dateEnd": null,
        "Address": {
            "entityNumber": "0417497106",
            "entityNumberFormatted": "0417.497.106",
            "entityType": "enterprise",
            "street": {
                "nl": "Kerkstraat",
                "fr": "Rue de l'Église"
            },
            "addressNumber": 1,
            "addressAdditional": "Unit 12, Floor 5",
            "postOfficeBox": "Box 5",
            "zipcode": 2000,
            "city": {
                "nl": "Brussel",
                "fr": "Bruxelles"
            },
            "countryCode": "fr",
            "country": {
                "nl": "Frankrijk",
                "fr": "France",
                "en": "France",
                "de": "string"
            },
            "dateStart": "2020-01-01"
        },
        "Denominations": [
            {
                "Denomination": {
                    "entityNumber": "0417497106",
                    "entityNumberFormatted": "0417.497.106",
                    "entityType": "enterprise",
                    "language": "nl",
                    "value": "FaimMedia B.V.",
                    "type": "social",
                    "typeDescription": {
                        "nl": "Maatschappelijke naam",
                        "en": "Primary name",
                        "fr": "Dénomination sociale",
                        "de": "Primärname"
                    }
                },
                "matched": true,
                "score": 1
            },
            {
                "…": "…"
            }
        ],
        "Activities": [
            {
                "Activity": {
                    "activityGroup": "BTW001",
                    "activityGroupDescription": {
                        "nl": "BTW-activiteiten",
                        "fr": "Activités TVA",
                        "en": "VAT activities",
                        "de": "MwSt.-Aktivitäten"
                    },
                    "classification": "MAIN",
                    "classificationDescription": {
                        "nl": "Hoofdactiviteit",
                        "fr": "Activité principale",
                        "en": "Main activity",
                        "de": "Hauptaktivität"
                    },
                    "Nace": {
                        "naceVersion": 2008,
                        "naceCode": "474",
                        "description": {
                            "nl": "Detailhandel in ICT-apparatuur in gespecialiseerde winkels",
                            "fr": "Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé",
                            "de": "Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)",
                            "en": "Retail sale of information and communication equipment in specialised stores"
                        }
                    }
                }
            },
            {
                "…": "…"
            }
        ],
        "Contacts": [
            {
                "Contact": {
                    "enterpriseNumber": "0417497106",
                    "enterpriseNumberFormatted": "0417.497.106",
                    "typeCode": "phone",
                    "value": "0032123456789"
                }
            },
            {
                "…": "…"
            }
        ]
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Establishment not found

The specified Establishment number could not be found, please make sure the establishment number is valid and correct.
{
    "error": "The `establishment` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/establishment/{establishmentNumber}/activities

Retrieve all establishment activities.
Retrieve all activities by the establishment number.

Parameters Path

  • Field
    Type
    Description
  • establishmentNumber
    integer
    Number of the establishment
    Example: 2147197839

Parameters Query

  • Field
    Type
    Description
  • filter.naceVersion
    integer
    Filter on a specific NACE version
    Possible values: 2008 2025

Example

200 Successful response

All activities from the establishment.
  • Field
    Type
    Description
  • []
    array
  • Activity
    object
  • activityGroup
    string
    Possible values: BTW001 EDR001 OLK001 POR001 PPO001 RSZ001 SCO001
    Example: BTW001
  • activityGroupDescription
    object
  • nl
    string
    Dutch description
    Example: BTW-activiteiten
  • fr
    string
    French description
    Example: Activités TVA
  • en
    string
    English description
    Example: VAT activities
  • de
    string
    German description
    Example: MwSt.-Aktivitäten
  • classification
    string
    Possible values: ANCI MAIN SECO
    Example: MAIN
  • classificationDescription
    object
  • nl
    string
    Dutch description
    Example: Hoofdactiviteit
  • fr
    string
    French description
    Example: Activité principale
  • en
    string
    English description
    Example: Main activity
  • de
    string
    German description
    Example: Hauptaktivität
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/establishment/{establishmentNumber}/activities
[
    {
        "Activity": {
            "activityGroup": "BTW001",
            "activityGroupDescription": {
                "nl": "BTW-activiteiten",
                "fr": "Activités TVA",
                "en": "VAT activities",
                "de": "MwSt.-Aktivitäten"
            },
            "classification": "MAIN",
            "classificationDescription": {
                "nl": "Hoofdactiviteit",
                "fr": "Activité principale",
                "en": "Main activity",
                "de": "Hauptaktivität"
            },
            "Nace": {
                "naceVersion": 2008,
                "naceCode": "474",
                "description": {
                    "nl": "Detailhandel in ICT-apparatuur in gespecialiseerde winkels",
                    "fr": "Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé",
                    "de": "Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)",
                    "en": "Retail sale of information and communication equipment in specialised stores"
                }
            }
        }
    },
    {
        "…": "…"
    }
]
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Establishment not found

The specified Establishment number could not be found, please make sure the establishment number is valid and correct.
{
    "error": "The `establishment` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/establishment/{establishmentNumber}/address

Retrieve the address of the establishment.
Retrieve the address of the establishment.

Parameters Path

  • Field
    Type
    Description
  • establishmentNumber
    integer
    Number of the establishment
    Example: 2147197839

Example

200 Successful response

The specific address has been found.
  • Field
    Type
    Description
  • Address
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/establishment/{establishmentNumber}/address
{
    "Address": {
        "entityNumber": "0417497106",
        "entityNumberFormatted": "0417.497.106",
        "entityType": "enterprise",
        "street": {
            "nl": "Kerkstraat",
            "fr": "Rue de l'Église"
        },
        "addressNumber": 1,
        "addressAdditional": "Unit 12, Floor 5",
        "postOfficeBox": "Box 5",
        "zipcode": 2000,
        "city": {
            "nl": "Brussel",
            "fr": "Bruxelles"
        },
        "countryCode": "fr",
        "country": {
            "nl": "Frankrijk",
            "fr": "France",
            "en": "France",
            "de": "string"
        },
        "dateStart": "2020-01-01"
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Establishment not found

The specified Establishment number could not be found, please make sure the establishment number is valid and correct.
{
    "error": "The `establishment` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/establishment/{establishmentNumber}/contact
Large plan or up

Retrieve contact information of the establishment.
Retrieve contact information of the establishment (phone numbers, email addresses and websites). Please note that companies aren't required to provide these details, so not all establishments have contact information available.

Parameters Path

  • Field
    Type
    Description
  • establishmentNumber
    integer
    Number of the establishment
    Example: 2147197839

Example

200 Successful response

All contact information of the establishment.
  • Field
    Type
    Description
  • []
    array
  • Contact
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • typeCode
    string
    The type of contact information
    Possible values: phone email website
    Example: phone
  • value
    string
    The value of the contact type, could be a phone number, email adress or website, depending on the typeCode.
    Example: 0032123456789 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/establishment/{establishmentNumber}/contact
[
    {
        "Contact": {
            "enterpriseNumber": "0417497106",
            "enterpriseNumberFormatted": "0417.497.106",
            "typeCode": "phone",
            "value": "0032123456789"
        }
    },
    {
        "…": "…"
    }
]
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Establishment not found

The specified Establishment number could not be found, please make sure the establishment number is valid and correct.
{
    "error": "The `establishment` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

402 Larger plan required

The endpoint (or a parameter that is present), is only accessible for a specific plan. Please verify the request which plan is required and upgrade accordingly.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "code": -31
}

/establishment/{establishmentNumber}/denominations

Retrieve all establishment denominations.
Retrieve all the denominations (business names and trade names) by the establishment number.

Parameters Path

  • Field
    Type
    Description
  • establishmentNumber
    integer
    Number of the establishment
    Example: 2147197839

Example

200 Successful response

All denominations from the establishment.
  • Field
    Type
    Description
  • []
    array
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/establishment/{establishmentNumber}/denominations
[
    {
        "Denomination": {
            "entityNumber": "0417497106",
            "entityNumberFormatted": "0417.497.106",
            "entityType": "enterprise",
            "language": "nl",
            "value": "FaimMedia B.V.",
            "type": "social",
            "typeDescription": {
                "nl": "Maatschappelijke naam",
                "en": "Primary name",
                "fr": "Dénomination sociale",
                "de": "Primärname"
            }
        }
    },
    {
        "…": "…"
    }
]
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Establishment not found

The specified Establishment number could not be found, please make sure the establishment number is valid and correct.
{
    "error": "The `establishment` item specified could not be found",
    "type": "RequestException",
    "code": -2
}

/establishment/{establishmentNumber}/denomination/{language}

Retrieve a specific establishment denomination.
Retrieve a language specific establishment name by the establishment number and language.

Parameters Path

  • Field
    Type
    Description
  • establishmentNumber
    integer
    Number of the establishment
    Example: 2147197839
  • language
    string
    The language code of the denomination. Some denominations may not have the language specified, use the unknown value in this case.
    Possible values: unknown nl en fr de
    Example: nl

Example

200 Successful response

The denomination has been found.
  • Field
    Type
    Description
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/establishment/{establishmentNumber}/denomination/{language}
{
    "Denomination": {
        "entityNumber": "0417497106",
        "entityNumberFormatted": "0417.497.106",
        "entityType": "enterprise",
        "language": "nl",
        "value": "FaimMedia B.V.",
        "type": "social",
        "typeDescription": {
            "nl": "Maatschappelijke naam",
            "en": "Primary name",
            "fr": "Dénomination sociale",
            "de": "Primärname"
        }
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

Advanced searches

/entities/search
New! Search request Ultimate plans only

Search for multiple entities.
Advanced search for multiple entities with multiple parameters.

Parameters Query

  • Field
    Type
    Description
  • Denomination.value
    string
    Partial name search on denominations, requires a minimum 2 characters.
    Example: Bakker
  • Denomination.includeMatch
    boolean
    When true, each denomination in the response includes a matched boolean indicating whether it was the denomination that matched the search query.
    Example: 1
  • Denomination.includeScore
    boolean
    When true, each matched denomination in the response includes a relevance score (score) for that denomination.
    Example: 1
  • Address.street
    string
    Search on street name (matches both NL and FR street names).
    Example: Grote Markt
  • Address.city
    string
    Search on city name (matches both NL and FR city names).
    Example: Gent
  • Address.zipCode
    string
    Filter by zip code. Always performs a prefix match, so partial inputs work across all country formats. Providing a full zip code will still match only that exact code.
    Example: 2040
  • Address.addressNumberExact
    string
    Filter by exact address number.
    Example: 24A
  • Address.countryCode
    string
    Filter by address country code. Must be a valid ISO 3166-1 alpha-2 code. Also matches entities that have no country code set.
    Example: be
  • Entity.active
    string
    Filter entities by their active status.
    Possible values: active inactive all
    Example: active
  • Entity.type
    string
    Restrict results to a specific entity type.
    Possible values: enterprise establishment
    Example: enterprise
  • Enterprise.juridicalFormCode
    string
    Filter by juridical form code. Only applies when Entity.type is enterprise.
    Example: 015
  • Enterprise.juridicalSituationCode
    string
    Filter by juridical situation code. Only applies when Entity.type is enterprise.
    Example: 000
  • Activity.naceCode
    string
    Filter entities that have a specific NACE activity code.
    Example: 6201
  • Entity.dateStart
    Filter by registration date. Provide a single date (yyyy-mm-dd) for an exact match, or two comma-separated dates for a range (yyyy-mm-dd,yyyy-mm-dd). An array of up to two dates is also accepted. Both dates are required when providing a range.
  • Entity.dateEnd
    Filter by end date. Provide a single date (yyyy-mm-dd) for an exact match, or two comma-separated dates for a range (yyyy-mm-dd,yyyy-mm-dd). An array of up to two dates is also accepted. Both dates are required when providing a range.
  • include
    array
    Include additional relation datasets in the response. Each included relation counts as .2 × Pagination.countItems rounded down towards your request limit. The total cost of the request is returned in the X-Api-Request-Cost response header.
    Possible values: Address Denominations Activities Contacts EnterpriseFinancial EnterpriseRoles
    Example: DenominationsContacts
  • page
    integer
    The page of the results that should be returned
    Example: 2
  • limit
    integer
    The limit of results that should be returned, can be a value somewhere between 1 and your plan's maximum. If a higher value is used, this parameter is ignored and your plan's maximum is used instead.
    Example: 30

Example

200 Enterprise

All entities matching the provided search criteria.
  • Field
    Type
    Description
  • Entities
    array
  • type
    string
    The entity type
    Possible values: enterprise establishment
    Example: enterprise
  • Enterprise
    object
  • enterpriseNumber
    string
    The enterprise number as digits only.
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    The enterprise number as formatted human readable string.
    Example: 0417.497.106
  • vatNumber
    string
    VAT number
    Example: BE0417497106
  • active
    boolean
    Whether the registration status of the enterprise is active or inactive. This field will also be false if the enterprise is in a pre-registration state.
    Example: 1
  • type
    string
    The company type, natural for natural person or entity for legal entity.
    Possible values: natural entity
    Example: entity
  • typeDescription
    object
  • nl
    string
    Dutch description
    Example: Rechtspersoon
  • en
    string
    English description
    Example: Legal entity
  • fr
    string
    French description
    Example: Personne morale
  • de
    string
    German description
    Example: Juristische Person
  • JuridicalForm
    object
  • juridicalFormCode
    string
    Juridical Form code
    Example: 030
  • description
    object
  • nl
    string
    Dutch description of the juridical form
    Example: Buitenlandse entiteit
  • en
    string
    English description of the juridical form
    Example: Foreign entity
  • fr
    string
    French description of the juridical form
    Example: Entité étrangère
  • de
    string
    German description of the juridical form
    Example: Ausländische Einheit
  • abbreviation
    object
  • nl
    string
    Dutch abbreviation of the juridical form
    Example: Buitenlandse entiteit
  • en
    string
    English abbreviation of the juridical form
    Example: Foreign entity
  • fr
    string
    French abbreviation of the juridical form
    Example: Entité étrangère
  • de
    string
    German abbreviation of the juridical form
    Example: Ausländische Einheit
  • JuridicalSituation
    object
  • juridicalSituationCode
    string
    Juridical Situation code
    Example: 000
  • description
    object
  • nl
    string
    Dutch description of the juridical situation
    Example: Normale toestand
  • en
    string
    English description of the juridical situation
    Example: Foreign entity
  • fr
    string
    French description of the juridical situation
    Example: Situation normale
  • de
    string
    German description of the juridical situation
    Example: Gewöhnlicher Zustand
  • dateStart
    string
    Example: 2020-01-01
  • dateEnd
    stringnull
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname
  • matched
    boolean
    Whether this denomination matched the search query. Only present when the param Denomination.includeMatch is set to true and the denomination matched.
    Example: 1
  • score
    number
    Relevance score of this denomination match. Only present when the param Denomination.includeScore is set to true and the denomination matched.
    Example: 1.23
  • Activity
    object
  • activityGroup
    string
    Possible values: BTW001 EDR001 OLK001 POR001 PPO001 RSZ001 SCO001
    Example: BTW001
  • activityGroupDescription
    object
  • nl
    string
    Dutch description
    Example: BTW-activiteiten
  • fr
    string
    French description
    Example: Activités TVA
  • en
    string
    English description
    Example: VAT activities
  • de
    string
    German description
    Example: MwSt.-Aktivitäten
  • classification
    string
    Possible values: ANCI MAIN SECO
    Example: MAIN
  • classificationDescription
    object
  • nl
    string
    Dutch description
    Example: Hoofdactiviteit
  • fr
    string
    French description
    Example: Activité principale
  • en
    string
    English description
    Example: Main activity
  • de
    string
    German description
    Example: Hauptaktivität
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores
  • Contact
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • typeCode
    string
    The type of contact information
    Possible values: phone email website
    Example: phone
  • value
    string
    The value of the contact type, could be a phone number, email adress or website, depending on the typeCode.
    Example: 0032123456789
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • capitalValue
    integer
    Placed capital according to statutes
    Example: 100000
  • capitalValuta
    string
    The valuta of the placed capital, while EUR is the most common, this value can be any ISO-4217 code. It's also common for companies founded before the introduction of the Euro to have historical valuta, in example: BEF, FRF and NLG. Most foreign companies have foreign valuta present. Please visit wikipedia for an up-to-date ISO-4217 list of: - Active currency codes - Historic currency codes
    Example: EUR
  • annualAssembly
    integer
    The month of the annual assembly, range is 1 to 12.
    Example: 6
  • annualAssemblyMonth
    string
    Textual presentation in English of the annual assembly.
    Example: June
  • fiscalEnd
    string
    The end date of a regular fiscal year. The year is not present here and will be formatted as 0000.
    Example: 0000-12-21
  • fiscalSpecialStart
    string
    The start date of an exceptional fiscal year.
    Example: 2021-03-01
  • fiscalSpecialEnd
    string
    The end date of an exceptional fiscal year.
    Example: 2022-02-28
  • EnterpriseRole
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • nameFirst
    string
    First name of the board member
    Example: Frans
  • nameLast
    string
    Last name of the board member
    Example: Vanderbeek
  • parentEnterpriseNumber
    string
    The enterprise number of which the role is inherited from. If the nameLast and nameFirst fields are both empty, the legal entity of the parent enterprise fulfills this role.
    Example: 0417497105
  • parentEnterpriseNumberFormatted
    string
    The enterprise number formatted.
    Example: 0417.497.106
  • dateInOffice
    string
    The date the person was registered
    Example: 2021-01-01
  • Role
    object
  • roleCode
    integer
    Code of the function title. Please be aware that this code may change at anytime, so it's advisable not to put to much reference to this value. Or to check periodicly for any changes.
    Example: 5
  • title
    object
  • nl
    string
    Function title in Dutch
    Example: Zaakvoerder
  • en
    string
    Function title in English
    Example: Manager
  • fr
    string
    Function title in French
    Example: Gérant
  • de
    string
    Function title in German
    Example: Geschäftsführer
  • note
    object
    Possible note regarding function title
  • nl
    string
    Possible note regarding function title in Dutch
    Example: Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term "Zaakvoerder" vanaf 1 januari 2020 gelezen worden als "Bestuurder"
  • en
    string
    Possible note regarding the function title in English
    Example: Pursuant to the Code of Companies and Associations, the term "Manager" must, since January 1, 2020, be read as "Board member".
  • fr
    string
    Possible note regarding function title in French
    Example: En application du Code des sociétés et des associations, le terme "Gérant" doit, depuis le 1er janvier 2020, être lu comme étant "Administrateur".
  • de
    string
    Possible note regarding function title in German
    Example: Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff "Geschäftsführer" seit dem 1. Januar 2020 als "Verwalter" zu lesen.
  • Establishment
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • establishmentNumber
    string
    The establishment number without punctuation marks.
    Example: 2102217157
  • establishmentNumberFormatted
    string
    The estblishment number seperated by punctuation marks.
    Example: 2102.217.157
  • active
    boolean
    Whether the registration status of the establishment is active or inactive. This field will also be false if the establishment is in a pre-registration state.
    Example: 1
  • dateStart
    string
    Example: 2020-01-01
  • dateEnd
    stringnull
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname
  • matched
    boolean
    Whether this denomination matched the search query. Only present when Denomination.includeMatch=true.
    Example: 1
  • score
    number
    Relevance score of this denomination match. Only present when Denomination.includeScore=true and the denomination matched.
    Example: 1.23
  • Activity
    object
  • activityGroup
    string
    Possible values: BTW001 EDR001 OLK001 POR001 PPO001 RSZ001 SCO001
    Example: BTW001
  • activityGroupDescription
    object
  • nl
    string
    Dutch description
    Example: BTW-activiteiten
  • fr
    string
    French description
    Example: Activités TVA
  • en
    string
    English description
    Example: VAT activities
  • de
    string
    German description
    Example: MwSt.-Aktivitäten
  • classification
    string
    Possible values: ANCI MAIN SECO
    Example: MAIN
  • classificationDescription
    object
  • nl
    string
    Dutch description
    Example: Hoofdactiviteit
  • fr
    string
    French description
    Example: Activité principale
  • en
    string
    English description
    Example: Main activity
  • de
    string
    German description
    Example: Hauptaktivität
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores
  • Contact
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • typeCode
    string
    The type of contact information
    Possible values: phone email website
    Example: phone
  • value
    string
    The value of the contact type, could be a phone number, email adress or website, depending on the typeCode.
    Example: 0032123456789
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/entities/search
{
    "Entities": [
        {
            "type": "enterprise",
            "Enterprise": {
                "enterpriseNumber": "0417497106",
                "enterpriseNumberFormatted": "0417.497.106",
                "vatNumber": "BE0417497106",
                "active": true,
                "type": "entity",
                "typeDescription": {
                    "nl": "Rechtspersoon",
                    "en": "Legal entity",
                    "fr": "Personne morale",
                    "de": "Juristische Person"
                },
                "JuridicalForm": {
                    "juridicalFormCode": "030",
                    "description": {
                        "nl": "Buitenlandse entiteit",
                        "en": "Foreign entity",
                        "fr": "Entité étrangère",
                        "de": "Ausländische Einheit"
                    },
                    "abbreviation": {
                        "nl": "Buitenlandse entiteit",
                        "en": "Foreign entity",
                        "fr": "Entité étrangère",
                        "de": "Ausländische Einheit"
                    }
                },
                "JuridicalSituation": {
                    "juridicalSituationCode": "000",
                    "description": {
                        "nl": "Normale toestand",
                        "en": "Foreign entity",
                        "fr": "Situation normale",
                        "de": "Gewöhnlicher Zustand"
                    }
                },
                "dateStart": "2020-01-01",
                "dateEnd": null,
                "Address": {
                    "entityNumber": "0417497106",
                    "entityNumberFormatted": "0417.497.106",
                    "entityType": "enterprise",
                    "street": {
                        "nl": "Kerkstraat",
                        "fr": "Rue de l'Église"
                    },
                    "addressNumber": 1,
                    "addressAdditional": "Unit 12, Floor 5",
                    "postOfficeBox": "Box 5",
                    "zipcode": 2000,
                    "city": {
                        "nl": "Brussel",
                        "fr": "Bruxelles"
                    },
                    "countryCode": "fr",
                    "country": {
                        "nl": "Frankrijk",
                        "fr": "France",
                        "en": "France",
                        "de": "string"
                    },
                    "dateStart": "2020-01-01"
                },
                "Denominations": [
                    {
                        "Denomination": {
                            "entityNumber": "0417497106",
                            "entityNumberFormatted": "0417.497.106",
                            "entityType": "enterprise",
                            "language": "nl",
                            "value": "FaimMedia B.V.",
                            "type": "social",
                            "typeDescription": {
                                "nl": "Maatschappelijke naam",
                                "en": "Primary name",
                                "fr": "Dénomination sociale",
                                "de": "Primärname"
                            }
                        },
                        "matched": true,
                        "score": 1
                    },
                    {
                        "…": "…"
                    }
                ],
                "Activities": [
                    {
                        "Activity": {
                            "activityGroup": "BTW001",
                            "activityGroupDescription": {
                                "nl": "BTW-activiteiten",
                                "fr": "Activités TVA",
                                "en": "VAT activities",
                                "de": "MwSt.-Aktivitäten"
                            },
                            "classification": "MAIN",
                            "classificationDescription": {
                                "nl": "Hoofdactiviteit",
                                "fr": "Activité principale",
                                "en": "Main activity",
                                "de": "Hauptaktivität"
                            },
                            "Nace": {
                                "naceVersion": 2008,
                                "naceCode": "474",
                                "description": {
                                    "nl": "Detailhandel in ICT-apparatuur in gespecialiseerde winkels",
                                    "fr": "Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé",
                                    "de": "Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)",
                                    "en": "Retail sale of information and communication equipment in specialised stores"
                                }
                            }
                        }
                    },
                    {
                        "…": "…"
                    }
                ],
                "Contacts": [
                    {
                        "Contact": {
                            "enterpriseNumber": "0417497106",
                            "enterpriseNumberFormatted": "0417.497.106",
                            "typeCode": "phone",
                            "value": "0032123456789"
                        }
                    },
                    {
                        "…": "…"
                    }
                ],
                "EnterpriseFinancial": {
                    "enterpriseNumber": "0417497106",
                    "enterpriseNumberFormatted": "0417.497.106",
                    "capitalValue": 100000,
                    "capitalValuta": "EUR",
                    "annualAssembly": 6,
                    "annualAssemblyMonth": "June",
                    "fiscalEnd": "0000-12-21",
                    "fiscalSpecialStart": "2021-03-01",
                    "fiscalSpecialEnd": "2022-02-28"
                },
                "EnterpriseRoles": [
                    {
                        "EnterpriseRole": {
                            "enterpriseNumber": "0417497106",
                            "enterpriseNumberFormatted": "0417.497.106",
                            "nameFirst": "Frans",
                            "nameLast": "Vanderbeek",
                            "parentEnterpriseNumber": "0417497105",
                            "parentEnterpriseNumberFormatted": "0417.497.106",
                            "dateInOffice": "2021-01-01",
                            "Role": {
                                "roleCode": 5,
                                "title": {
                                    "nl": "Zaakvoerder",
                                    "en": "Manager",
                                    "fr": "Gérant",
                                    "de": "Geschäftsführer"
                                },
                                "note": {
                                    "nl": "Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term \"Zaakvoerder\" vanaf 1 januari 2020 gelezen worden als \"Bestuurder\"\n",
                                    "en": "Pursuant to the Code of Companies and Associations, the term \"Manager\" must, since January 1, 2020, be read as \"Board member\".\n",
                                    "fr": "En application du Code des sociétés et des associations, le terme \"Gérant\" doit, depuis le 1er janvier 2020, être lu comme étant \"Administrateur\".\n",
                                    "de": "Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff \"Geschäftsführer\" seit dem 1. Januar 2020 als \"Verwalter\" zu lesen.\n"
                                }
                            }
                        }
                    },
                    {
                        "…": "…"
                    }
                ]
            }
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

200 Establishment

All entities matching the provided search criteria.
  • Field
    Type
    Description
  • Entities
    array
  • type
    string
    The entity type
    Possible values: enterprise establishment
    Example: enterprise
  • Enterprise
    object
  • enterpriseNumber
    string
    The enterprise number as digits only.
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    The enterprise number as formatted human readable string.
    Example: 0417.497.106
  • vatNumber
    string
    VAT number
    Example: BE0417497106
  • active
    boolean
    Whether the registration status of the enterprise is active or inactive. This field will also be false if the enterprise is in a pre-registration state.
    Example: 1
  • type
    string
    The company type, natural for natural person or entity for legal entity.
    Possible values: natural entity
    Example: entity
  • typeDescription
    object
  • nl
    string
    Dutch description
    Example: Rechtspersoon
  • en
    string
    English description
    Example: Legal entity
  • fr
    string
    French description
    Example: Personne morale
  • de
    string
    German description
    Example: Juristische Person
  • JuridicalForm
    object
  • juridicalFormCode
    string
    Juridical Form code
    Example: 030
  • description
    object
  • nl
    string
    Dutch description of the juridical form
    Example: Buitenlandse entiteit
  • en
    string
    English description of the juridical form
    Example: Foreign entity
  • fr
    string
    French description of the juridical form
    Example: Entité étrangère
  • de
    string
    German description of the juridical form
    Example: Ausländische Einheit
  • abbreviation
    object
  • nl
    string
    Dutch abbreviation of the juridical form
    Example: Buitenlandse entiteit
  • en
    string
    English abbreviation of the juridical form
    Example: Foreign entity
  • fr
    string
    French abbreviation of the juridical form
    Example: Entité étrangère
  • de
    string
    German abbreviation of the juridical form
    Example: Ausländische Einheit
  • JuridicalSituation
    object
  • juridicalSituationCode
    string
    Juridical Situation code
    Example: 000
  • description
    object
  • nl
    string
    Dutch description of the juridical situation
    Example: Normale toestand
  • en
    string
    English description of the juridical situation
    Example: Foreign entity
  • fr
    string
    French description of the juridical situation
    Example: Situation normale
  • de
    string
    German description of the juridical situation
    Example: Gewöhnlicher Zustand
  • dateStart
    string
    Example: 2020-01-01
  • dateEnd
    stringnull
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname
  • matched
    boolean
    Whether this denomination matched the search query. Only present when the param Denomination.includeMatch is set to true and the denomination matched.
    Example: 1
  • score
    number
    Relevance score of this denomination match. Only present when the param Denomination.includeScore is set to true and the denomination matched.
    Example: 1
  • Activity
    object
  • activityGroup
    string
    Possible values: BTW001 EDR001 OLK001 POR001 PPO001 RSZ001 SCO001
    Example: BTW001
  • activityGroupDescription
    object
  • nl
    string
    Dutch description
    Example: BTW-activiteiten
  • fr
    string
    French description
    Example: Activités TVA
  • en
    string
    English description
    Example: VAT activities
  • de
    string
    German description
    Example: MwSt.-Aktivitäten
  • classification
    string
    Possible values: ANCI MAIN SECO
    Example: MAIN
  • classificationDescription
    object
  • nl
    string
    Dutch description
    Example: Hoofdactiviteit
  • fr
    string
    French description
    Example: Activité principale
  • en
    string
    English description
    Example: Main activity
  • de
    string
    German description
    Example: Hauptaktivität
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores
  • Contact
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • typeCode
    string
    The type of contact information
    Possible values: phone email website
    Example: phone
  • value
    string
    The value of the contact type, could be a phone number, email adress or website, depending on the typeCode.
    Example: 0032123456789
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • capitalValue
    integer
    Placed capital according to statutes
    Example: 100000
  • capitalValuta
    string
    The valuta of the placed capital, while EUR is the most common, this value can be any ISO-4217 code. It's also common for companies founded before the introduction of the Euro to have historical valuta, in example: BEF, FRF and NLG. Most foreign companies have foreign valuta present. Please visit wikipedia for an up-to-date ISO-4217 list of: - Active currency codes - Historic currency codes
    Example: EUR
  • annualAssembly
    integer
    The month of the annual assembly, range is 1 to 12.
    Example: 6
  • annualAssemblyMonth
    string
    Textual presentation in English of the annual assembly.
    Example: June
  • fiscalEnd
    string
    The end date of a regular fiscal year. The year is not present here and will be formatted as 0000.
    Example: 0000-12-21
  • fiscalSpecialStart
    string
    The start date of an exceptional fiscal year.
    Example: 2021-03-01
  • fiscalSpecialEnd
    string
    The end date of an exceptional fiscal year.
    Example: 2022-02-28
  • EnterpriseRole
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • nameFirst
    string
    First name of the board member
    Example: Frans
  • nameLast
    string
    Last name of the board member
    Example: Vanderbeek
  • parentEnterpriseNumber
    string
    The enterprise number of which the role is inherited from. If the nameLast and nameFirst fields are both empty, the legal entity of the parent enterprise fulfills this role.
    Example: 0417497105
  • parentEnterpriseNumberFormatted
    string
    The enterprise number formatted.
    Example: 0417.497.106
  • dateInOffice
    string
    The date the person was registered
    Example: 2021-01-01
  • Role
    object
  • roleCode
    integer
    Code of the function title. Please be aware that this code may change at anytime, so it's advisable not to put to much reference to this value. Or to check periodicly for any changes.
    Example: 5
  • title
    object
  • nl
    string
    Function title in Dutch
    Example: Zaakvoerder
  • en
    string
    Function title in English
    Example: Manager
  • fr
    string
    Function title in French
    Example: Gérant
  • de
    string
    Function title in German
    Example: Geschäftsführer
  • note
    object
    Possible note regarding function title
  • nl
    string
    Possible note regarding function title in Dutch
    Example: Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term "Zaakvoerder" vanaf 1 januari 2020 gelezen worden als "Bestuurder"
  • en
    string
    Possible note regarding the function title in English
    Example: Pursuant to the Code of Companies and Associations, the term "Manager" must, since January 1, 2020, be read as "Board member".
  • fr
    string
    Possible note regarding function title in French
    Example: En application du Code des sociétés et des associations, le terme "Gérant" doit, depuis le 1er janvier 2020, être lu comme étant "Administrateur".
  • de
    string
    Possible note regarding function title in German
    Example: Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff "Geschäftsführer" seit dem 1. Januar 2020 als "Verwalter" zu lesen.
  • Establishment
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • establishmentNumber
    string
    The establishment number without punctuation marks.
    Example: 2102217157
  • establishmentNumberFormatted
    string
    The estblishment number seperated by punctuation marks.
    Example: 2102.217.157
  • active
    boolean
    Whether the registration status of the establishment is active or inactive. This field will also be false if the establishment is in a pre-registration state.
    Example: 1
  • dateStart
    string
    Example: 2020-01-01
  • dateEnd
    stringnull
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname
  • matched
    boolean
    Whether this denomination matched the search query. Only present when Denomination.includeMatch=true.
    Example: 1
  • score
    number
    Relevance score of this denomination match. Only present when Denomination.includeScore=true and the denomination matched.
    Example: 1.23
  • Activity
    object
  • activityGroup
    string
    Possible values: BTW001 EDR001 OLK001 POR001 PPO001 RSZ001 SCO001
    Example: BTW001
  • activityGroupDescription
    object
  • nl
    string
    Dutch description
    Example: BTW-activiteiten
  • fr
    string
    French description
    Example: Activités TVA
  • en
    string
    English description
    Example: VAT activities
  • de
    string
    German description
    Example: MwSt.-Aktivitäten
  • classification
    string
    Possible values: ANCI MAIN SECO
    Example: MAIN
  • classificationDescription
    object
  • nl
    string
    Dutch description
    Example: Hoofdactiviteit
  • fr
    string
    French description
    Example: Activité principale
  • en
    string
    English description
    Example: Main activity
  • de
    string
    German description
    Example: Hauptaktivität
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores
  • Contact
    object
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106
  • typeCode
    string
    The type of contact information
    Possible values: phone email website
    Example: phone
  • value
    string
    The value of the contact type, could be a phone number, email adress or website, depending on the typeCode.
    Example: 0032123456789
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/entities/search
{
    "Entities": [
        {
            "type": "enterprise",
            "Establishment": {
                "enterpriseNumber": "0417497106",
                "enterpriseNumberFormatted": "0417.497.106",
                "establishmentNumber": "2102217157",
                "establishmentNumberFormatted": "2102.217.157",
                "active": true,
                "dateStart": "2020-01-01",
                "dateEnd": null,
                "Address": {
                    "entityNumber": "0417497106",
                    "entityNumberFormatted": "0417.497.106",
                    "entityType": "enterprise",
                    "street": {
                        "nl": "Kerkstraat",
                        "fr": "Rue de l'Église"
                    },
                    "addressNumber": 1,
                    "addressAdditional": "Unit 12, Floor 5",
                    "postOfficeBox": "Box 5",
                    "zipcode": 2000,
                    "city": {
                        "nl": "Brussel",
                        "fr": "Bruxelles"
                    },
                    "countryCode": "fr",
                    "country": {
                        "nl": "Frankrijk",
                        "fr": "France",
                        "en": "France",
                        "de": "string"
                    },
                    "dateStart": "2020-01-01"
                },
                "Denominations": [
                    {
                        "Denomination": {
                            "entityNumber": "0417497106",
                            "entityNumberFormatted": "0417.497.106",
                            "entityType": "enterprise",
                            "language": "nl",
                            "value": "FaimMedia B.V.",
                            "type": "social",
                            "typeDescription": {
                                "nl": "Maatschappelijke naam",
                                "en": "Primary name",
                                "fr": "Dénomination sociale",
                                "de": "Primärname"
                            }
                        },
                        "matched": true,
                        "score": 1
                    },
                    {
                        "…": "…"
                    }
                ],
                "Activities": [
                    {
                        "Activity": {
                            "activityGroup": "BTW001",
                            "activityGroupDescription": {
                                "nl": "BTW-activiteiten",
                                "fr": "Activités TVA",
                                "en": "VAT activities",
                                "de": "MwSt.-Aktivitäten"
                            },
                            "classification": "MAIN",
                            "classificationDescription": {
                                "nl": "Hoofdactiviteit",
                                "fr": "Activité principale",
                                "en": "Main activity",
                                "de": "Hauptaktivität"
                            },
                            "Nace": {
                                "naceVersion": 2008,
                                "naceCode": "474",
                                "description": {
                                    "nl": "Detailhandel in ICT-apparatuur in gespecialiseerde winkels",
                                    "fr": "Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé",
                                    "de": "Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)",
                                    "en": "Retail sale of information and communication equipment in specialised stores"
                                }
                            }
                        }
                    },
                    {
                        "…": "…"
                    }
                ],
                "Contacts": [
                    {
                        "Contact": {
                            "enterpriseNumber": "0417497106",
                            "enterpriseNumberFormatted": "0417.497.106",
                            "typeCode": "phone",
                            "value": "0032123456789"
                        }
                    },
                    {
                        "…": "…"
                    }
                ]
            }
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

422 Invalid response, missing or incorrect parameter 

{
    "type": "RequestException",
    "error": "Missing `query` parameter",
    "code": -3
}

402 Larger plan required

The endpoint (or a parameter that is present), is only accessible for a specific plan. Please verify the request which plan is required and upgrade accordingly.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "code": -31
}

Company name searches

/denominations
Search request

Autocomplete company names (denominations)
Search for denominations (trade name) by using keywords. Both enterprises and establishments can have one or more denominations. Although an enterprise almost always has at lease one denominations, this must not be assumed. So it is adviced to verify any denominations that belong to the enterprise' establishments.

Parameters Query

  • Field
    Type
    Description
  • query
    string
    The keywords to search for the denominations.
    Example: AB Inbev
  • entityType
    string
    Accepted values: enterprise: show only enterprises, establishment: show only establishments
    Possible values: enterprise establishment
    Example: enterprise
  • type
    string
    Filter on the type of denomination.
    Possible values: social abbreviation commercial
    Example: commercial
  • active Large plan or up
    string
    Choose if you want search results from inactive enterprises and establishments returned. The default is only active.
    Possible values: active inactive all
    Example: active
  • language
    string
    Search only in this language specified fields
    Possible values: nl fr en de
    Example: nl
  • page
    integer
    The page of the results that should be returned
    Example: 2
  • limit
    integer
    The limit of results that should be returned, can be a value somewhere between 1 and your plan's maximum. If a higher value is used, this parameter is ignored and your plan's maximum is used instead.
    Example: 30

Example

200 Successful response

All denominations matching the provided search criteria.
  • Field
    Type
    Description
  • Denominations
    array
  • Denomination
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • language
    string
    Possible values: unknown nl en fr de
    Example: nl
  • value
    string
    The denomination name
    Example: FaimMedia B.V.
  • type
    string
    The denomination type
    Possible values: social abbreviation commercial
    Example: social
  • typeDescription
    object
  • nl
    string
    Dutch translation of the type description
    Example: Maatschappelijke naam
  • en
    string
    English translation of the type description
    Example: Primary name
  • fr
    string
    French translation of the type description
    Example: Dénomination sociale
  • de
    string
    German translation of the type description
    Example: Primärname
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/denominations
{
    "Denominations": [
        {
            "Denomination": {
                "entityNumber": "0417497106",
                "entityNumberFormatted": "0417.497.106",
                "entityType": "enterprise",
                "language": "nl",
                "value": "FaimMedia B.V.",
                "type": "social",
                "typeDescription": {
                    "nl": "Maatschappelijke naam",
                    "en": "Primary name",
                    "fr": "Dénomination sociale",
                    "de": "Primärname"
                }
            }
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

422 Invalid response, missing or incorrect parameter 

{
    "type": "RequestException",
    "error": "Missing `query` parameter",
    "code": -3
}

402 Larger plan required for this parameter

The parameter you are using, is only accessible for a larger plan. Please verify the request which plan is required and upgrade your plan or omit the parameter.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "parameter": "active",
    "code": -31
}

Address searches

/addresses
Search request

Search for multiple addresses.
Search for multiple addresses by query parameter.

Parameters Query

  • Field
    Type
    Description
  • query
    string
    Search query
    Example: Grote Markt
  • entityType
    string
    Filter for a specific entity type
    Possible values: enterprise establishment
    Example: enterprise
  • active Large plan or up
    string
    Choose if you want search results from inactive enterprises and establishments returned. The default is only active.
    Possible values: active inactive all
    Example: active
  • fields[]
    array
    Provide the fields that need to be queried. Possible values:
    • street: Search in the street field
    • zipcode: Search in the zipcode field
    • city: Search in the city field
    • country: Search in the country field
    Possible values: street zipcode city
  • filter.zipCodeExact Large plan or up
    string
    Filter for exact zipcode match
    Example: 2040
  • filter.addressNumberExact Large plan or up
    string
    Filter for an exact address number match
    Example: 24A
  • filter.countryCode Large plan or up
    string
    Filter for address country code, this must be an valid ISO 3166-1 alpha-2 country code
    Example: be
  • page
    integer
    The page of the results that should be returned
    Example: 2
  • limit
    integer
    The limit of results that should be returned, can be a value somewhere between 1 and your plan's maximum. If a higher value is used, this parameter is ignored and your plan's maximum is used instead.
    Example: 30

Example

200 Successful response

All addresses matching the provided search criteria.
  • Field
    Type
    Description
  • Addresses
    array
  • Address
    object
  • entityNumber
    string
    Example: 0417497106
  • entityNumberFormatted
    string
    Example: 0417.497.106
  • entityType
    string
    Possible values: enterprise establishment
    Example: enterprise
  • street
    object
    Street of the registration
  • nl
    string
    Dutch street translation of the registration
    Example: Kerkstraat
  • fr
    string
    French street translation of the registration
    Example: Rue de l'Église
  • addressNumber
    string
    Address street number of the registration
    Example: 1
  • addressAdditional
    string
    Additional address or street suffix
    Example: Unit 12, Floor 5
  • postOfficeBox
    string
    The post office box of the address, if applicable
    Example: Box 5
  • zipcode
    string
    Zipcode of the registration
    Example: 2000
  • city
    object
    City of the registration
  • nl
    string
    Dutch city translation of the registration
    Example: Brussel
  • fr
    string
    French city translation of the registration
    Example: Bruxelles
  • countryCode
    string
    The ISO 3166-1 alpha-2 country code of the address.
    Example: fr
  • country
    object
    Translated name of the country code.
  • nl
    string
    Dutch translation of the country
    Example: Frankrijk
  • fr
    string
    French translation of the country
    Example: France
  • en
    string
    English translation of the country
    Example: France
  • de
    string
    German translation of the country
  • dateStart
    string
    Example: 2020-01-01
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/addresses
{
    "Addresses": [
        {
            "Address": {
                "entityNumber": "0417497106",
                "entityNumberFormatted": "0417.497.106",
                "entityType": "enterprise",
                "street": {
                    "nl": "Kerkstraat",
                    "fr": "Rue de l'Église"
                },
                "addressNumber": 1,
                "addressAdditional": "Unit 12, Floor 5",
                "postOfficeBox": "Box 5",
                "zipcode": 2000,
                "city": {
                    "nl": "Brussel",
                    "fr": "Bruxelles"
                },
                "countryCode": "fr",
                "country": {
                    "nl": "Frankrijk",
                    "fr": "France",
                    "en": "France",
                    "de": "string"
                },
                "dateStart": "2020-01-01"
            }
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

422 Invalid response, missing or incorrect parameter 

{
    "type": "RequestException",
    "error": "Missing `query` parameter",
    "code": -3
}

402 Larger plan required for this parameter

The parameter you are using, is only accessible for a larger plan. Please verify the request which plan is required and upgrade your plan or omit the parameter.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "parameter": "active",
    "code": -31
}

Nace

/naces
Search request

Search for nace code

Parameters Query

  • Field
    Type
    Description
  • query
    string
    Search query
    Example: ICT-apparatuur
  • language
    string
    Specify in which language should be searched. If this parameter is omitted, all available languages will be searched.
    Possible values: nl fr de en
    Example: nl
  • filter.naceVersion
    integer
    Filter on a specific NACE version
    Possible values: 2008 2025
  • page
    integer
    The page of the results that should be returned
    Example: 2
  • limit
    integer
    The limit of results that should be returned, can be a value somewhere between 1 and your plan's maximum. If a higher value is used, this parameter is ignored and your plan's maximum is used instead.
    Example: 30

Example

200 Successful response

All NACEs matching the provided search criteria.
  • Field
    Type
    Description
  • Naces
    array
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/naces
{
    "Naces": [
        {
            "Nace": {
                "naceVersion": 2008,
                "naceCode": "474",
                "description": {
                    "nl": "Detailhandel in ICT-apparatuur in gespecialiseerde winkels",
                    "fr": "Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé",
                    "de": "Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)",
                    "en": "Retail sale of information and communication equipment in specialised stores"
                }
            }
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

/nace/{naceVersion}/{naceCode}

Get NACE by version and code

Parameters Path

  • Field
    Type
    Description
  • naceVersion
    integer
    NACE version
    Possible values: 2008 2025
    Example: 2025
  • naceCode
    string
    NACE code
    Example: 01

Example

200 Successful response, NACE is found.

  • Field
    Type
    Description
  • Nace
    object
  • naceVersion
    integer
    Example: 2008
  • naceCode
    string
    Example: 474
  • description
    object
  • nl
    string
    Dutch description
    Example: Detailhandel in ICT-apparatuur in gespecialiseerde winkels
  • fr
    string
    French description
    Example: Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé
  • de
    string
    German description
    Example: Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)
  • en
    string
    English description
    Example: Retail sale of information and communication equipment in specialised stores 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/nace/{naceVersion}/{naceCode}
{
    "Nace": {
        "naceVersion": 2008,
        "naceCode": "474",
        "description": {
            "nl": "Detailhandel in ICT-apparatuur in gespecialiseerde winkels",
            "fr": "Commerce de détail d'équipements de l'information et de la communication en magasin spécialisé",
            "de": "Einzelhandel mit Geräten der Informations- und Kommunikationstechnik (in Verkaufsräumen)",
            "en": "Retail sale of information and communication equipment in specialised stores"
        }
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

Roles

/roles
Large plan or up Search request

Search for a role code (function title)

Parameters Query

  • Field
    Type
    Description
  • query
    string
    Search query, will search for a partial role title
    Example: Manager
  • language
    string
    Specify in which language should be searched. If this parameter is omitted, all available languages will be searched.
    Possible values: nl en fr de
    Example: en
  • page
    integer
    The page of the results that should be returned
    Example: 2
  • limit
    integer
    The limit of results that should be returned, can be a value somewhere between 1 and your plan's maximum. If a higher value is used, this parameter is ignored and your plan's maximum is used instead.
    Example: 30

Example

200 Successful response

All function titles returned
  • Field
    Type
    Description
  • Roles
    array
  • Role
    object
  • roleCode
    integer
    Code of the function title. Please be aware that this code may change at anytime, so it's advisable not to put to much reference to this value. Or to check periodicly for any changes.
    Example: 5
  • title
    object
  • nl
    string
    Function title in Dutch
    Example: Zaakvoerder
  • en
    string
    Function title in English
    Example: Manager
  • fr
    string
    Function title in French
    Example: Gérant
  • de
    string
    Function title in German
    Example: Geschäftsführer
  • note
    object
    Possible note regarding function title
  • nl
    string
    Possible note regarding function title in Dutch
    Example: Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term "Zaakvoerder" vanaf 1 januari 2020 gelezen worden als "Bestuurder"
  • en
    string
    Possible note regarding the function title in English
    Example: Pursuant to the Code of Companies and Associations, the term "Manager" must, since January 1, 2020, be read as "Board member".
  • fr
    string
    Possible note regarding function title in French
    Example: En application du Code des sociétés et des associations, le terme "Gérant" doit, depuis le 1er janvier 2020, être lu comme étant "Administrateur".
  • de
    string
    Possible note regarding function title in German
    Example: Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff "Geschäftsführer" seit dem 1. Januar 2020 als "Verwalter" zu lesen.
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/roles
{
    "Roles": [
        {
            "Role": {
                "roleCode": 5,
                "title": {
                    "nl": "Zaakvoerder",
                    "en": "Manager",
                    "fr": "Gérant",
                    "de": "Geschäftsführer"
                },
                "note": {
                    "nl": "Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term \"Zaakvoerder\" vanaf 1 januari 2020 gelezen worden als \"Bestuurder\"\n",
                    "en": "Pursuant to the Code of Companies and Associations, the term \"Manager\" must, since January 1, 2020, be read as \"Board member\".\n",
                    "fr": "En application du Code des sociétés et des associations, le terme \"Gérant\" doit, depuis le 1er janvier 2020, être lu comme étant \"Administrateur\".\n",
                    "de": "Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff \"Geschäftsführer\" seit dem 1. Januar 2020 als \"Verwalter\" zu lesen.\n"
                }
            }
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

402 Larger plan required

The endpoint (or a parameter that is present), is only accessible for a specific plan. Please verify the request which plan is required and upgrade accordingly.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "code": -31
}

/role/{roleCode}
Large plan or up

Get a specific function title by code

Parameters Path

  • Field
    Type
    Description
  • roleCode
    integer
    The role code
    Example: 5

Example

200 Successful response

Function title is returned
  • Field
    Type
    Description
  • Role
    object
  • roleCode
    integer
    Code of the function title. Please be aware that this code may change at anytime, so it's advisable not to put to much reference to this value. Or to check periodicly for any changes.
    Example: 5
  • title
    object
  • nl
    string
    Function title in Dutch
    Example: Zaakvoerder
  • en
    string
    Function title in English
    Example: Manager
  • fr
    string
    Function title in French
    Example: Gérant
  • de
    string
    Function title in German
    Example: Geschäftsführer
  • note
    object
    Possible note regarding function title
  • nl
    string
    Possible note regarding function title in Dutch
    Example: Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term "Zaakvoerder" vanaf 1 januari 2020 gelezen worden als "Bestuurder"
  • en
    string
    Possible note regarding the function title in English
    Example: Pursuant to the Code of Companies and Associations, the term "Manager" must, since January 1, 2020, be read as "Board member".
  • fr
    string
    Possible note regarding function title in French
    Example: En application du Code des sociétés et des associations, le terme "Gérant" doit, depuis le 1er janvier 2020, être lu comme étant "Administrateur".
  • de
    string
    Possible note regarding function title in German
    Example: Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff "Geschäftsführer" seit dem 1. Januar 2020 als "Verwalter" zu lesen. 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/role/{roleCode}
{
    "Role": {
        "roleCode": 5,
        "title": {
            "nl": "Zaakvoerder",
            "en": "Manager",
            "fr": "Gérant",
            "de": "Geschäftsführer"
        },
        "note": {
            "nl": "Overeenkomstig het Wetboek van Vennootschappen en Verenigingen moet de term \"Zaakvoerder\" vanaf 1 januari 2020 gelezen worden als \"Bestuurder\"\n",
            "en": "Pursuant to the Code of Companies and Associations, the term \"Manager\" must, since January 1, 2020, be read as \"Board member\".\n",
            "fr": "En application du Code des sociétés et des associations, le terme \"Gérant\" doit, depuis le 1er janvier 2020, être lu comme étant \"Administrateur\".\n",
            "de": "Gemäß dem Gesellschafts- und Vereinigungsgesetzbuch ist der Begriff \"Geschäftsführer\" seit dem 1. Januar 2020 als \"Verwalter\" zu lesen.\n"
        }
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

402 Larger plan required

The endpoint (or a parameter that is present), is only accessible for a specific plan. Please verify the request which plan is required and upgrade accordingly.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "code": -31
}

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

Juridical

/juridical-forms
Large plan or up Search request

Search for a juridical form

Parameters Query

  • Field
    Type
    Description
  • query
    string
    Search query, will search for a (partial) juridical form
    Example: Vennoot
  • language
    string
    Specify in which language should be searched. If this parameter is omitted, all available languages will be searched.
    Possible values: nl fr de en
    Example: nl
  • page
    integer
    The page of the results that should be returned
    Example: 2
  • limit
    integer
    The limit of results that should be returned, can be a value somewhere between 1 and your plan's maximum. If a higher value is used, this parameter is ignored and your plan's maximum is used instead.
    Example: 30

Example

200 Successful response

All juridical forms matching your search criteria are returned.
  • Field
    Type
    Description
  • JuridicalForms
    array
  • JuridicalForm
    object
  • juridicalFormCode
    string
    Juridical Form code
    Example: 030
  • description
    object
  • nl
    string
    Dutch description of the juridical form
    Example: Buitenlandse entiteit
  • en
    string
    English description of the juridical form
    Example: Foreign entity
  • fr
    string
    French description of the juridical form
    Example: Entité étrangère
  • de
    string
    German description of the juridical form
    Example: Ausländische Einheit
  • abbreviation
    object
  • nl
    string
    Dutch abbreviation of the juridical form
    Example: Buitenlandse entiteit
  • en
    string
    English abbreviation of the juridical form
    Example: Foreign entity
  • fr
    string
    French abbreviation of the juridical form
    Example: Entité étrangère
  • de
    string
    German abbreviation of the juridical form
    Example: Ausländische Einheit
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/juridical-forms
{
    "JuridicalForms": [
        {
            "JuridicalForm": {
                "juridicalFormCode": "030",
                "description": {
                    "nl": "Buitenlandse entiteit",
                    "en": "Foreign entity",
                    "fr": "Entité étrangère",
                    "de": "Ausländische Einheit"
                },
                "abbreviation": {
                    "nl": "Buitenlandse entiteit",
                    "en": "Foreign entity",
                    "fr": "Entité étrangère",
                    "de": "Ausländische Einheit"
                }
            }
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

402 Larger plan required

The endpoint (or a parameter that is present), is only accessible for a specific plan. Please verify the request which plan is required and upgrade accordingly.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "code": -31
}

/juridical-situations
Large plan or up Search request

Search for a juridical situation

Parameters Query

  • Field
    Type
    Description
  • query
    string
    Search query, will search for a (partial) juridical situation
    Example: Stop
  • language
    string
    Specify in which language should be searched. If this parameter is omitted, all available languages will be searched.
    Possible values: nl fr de en
    Example: nl
  • page
    integer
    The page of the results that should be returned
    Example: 2
  • limit
    integer
    The limit of results that should be returned, can be a value somewhere between 1 and your plan's maximum. If a higher value is used, this parameter is ignored and your plan's maximum is used instead.
    Example: 30

Example

200 Successful response

All juridical situations matching your search criteria are returned.
  • Field
    Type
    Description
  • JuridicalSituations
    array
  • JuridicalSituation
    object
  • juridicalSituationCode
    string
    Juridical Situation code
    Example: 000
  • description
    object
  • nl
    string
    Dutch description of the juridical situation
    Example: Normale toestand
  • en
    string
    English description of the juridical situation
    Example: Foreign entity
  • fr
    string
    French description of the juridical situation
    Example: Situation normale
  • de
    string
    German description of the juridical situation
    Example: Gewöhnlicher Zustand
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/juridical-situations
{
    "JuridicalSituations": [
        {
            "JuridicalSituation": {
                "juridicalSituationCode": "000",
                "description": {
                    "nl": "Normale toestand",
                    "en": "Foreign entity",
                    "fr": "Situation normale",
                    "de": "Gewöhnlicher Zustand"
                }
            }
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

402 Larger plan required

The endpoint (or a parameter that is present), is only accessible for a specific plan. Please verify the request which plan is required and upgrade accordingly.
{
    "error": "Your active plan doesn't meet the requirements for this endpoint",
    "type": "PlanScopeException",
    "code": -31
}

VAT

/vat/{vatNumber}

Verify VAT-number or enterprise number for internation transactions within the EU
Please note: we use an external service for validating VAT-numbers this may not always be available. Only use this method for validating the VAT-number for international transactions within the EU, not for retrieving company information, you may use the /enterprise endpoints for that purpose. Even though the response may say the VAT-number is invalid, it may still be valid for domestic transactions.

Parameters Path

  • Field
    Type
    Description
  • vatNumber
    string
    The VAT-number to be validated, a valid Belgian VAT-number starts with BE followed by 10 digits. The field may also contains a valid Enterprise number
    Example: BE0417497106

Example

200 Successful response

The VAT-number has been validated. Please note: this does not necessary mean the provided VAT-number is valid, check the `isValid` value of the response.
  • Field
    Type
    Description
  • Vat
    object
  • vatNumber
    string
    The validated VAT-number
    Example: BE0417497106
  • isValid
    boolean
    Boolean if provided VAT-number is valid
    Example: 1
  • details
    object
  • name
    string
    Example: NV BELFIUS BANK
  • address
    string
    Use the enterprise address endpoint instead.
    Example: Karel Rogierplein 11, 1210 Sint-Joost-ten-Node
  • enterpriseNumber
    string
    Example: 0417497106
  • enterpriseNumberFormatted
    string
    Example: 0417.497.106 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/vat/{vatNumber}
{
    "Vat": {
        "vatNumber": "BE0417497106",
        "isValid": true,
        "details": {
            "name": "NV BELFIUS BANK",
            "address": "Karel Rogierplein 11, 1210 Sint-Joost-ten-Node"
        },
        "enterpriseNumber": "0417497106",
        "enterpriseNumberFormatted": "0417.497.106"
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

500 Service for VAT-validation is not available.

Webhooks

/webhooks
Medium plan or up

Get a list of all webhooks

Example

200 Success response

List of all webhooks
  • Field
    Type
    Description
  • []
    array
  • name
    string
    The name of the webhook
    Example: My webhook
  • url
    string
    The url of the webhook to be called
    Example: https://your-server.com/example-webhook
  • hmacSecret
    string
    The secret to be used to generate the HMAC token send along with the request. The secret will only be shown once upon creation, so make sure to save it after creation.
    Example: gmuNr1obKyct6FOXj6TCHTinJthlbo44
  • disabled
    boolean
    Whether the webhook is disabled or not, this can be done manually, but also if the webhook has failed too many days in a row.
  • createdAt
    string
    The date and time the webhook was created.
    Example: 2025-10-01T20:00:00Z
  • lastTriggeredAt
    string
    The last date and time the webhook was triggered. This can also be a manually trigger.
    Example: 2025-10-08T06:00:00Z 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/webhooks
[
    {
        "name": "My webhook",
        "url": "https://your-server.com/example-webhook",
        "hmacSecret": "gmuNr1obKyct6FOXj6TCHTinJthlbo44",
        "disabled": false,
        "createdAt": "2025-10-01T20:00:00Z",
        "lastTriggeredAt": "2025-10-08T06:00:00Z"
    },
    {
        "…": "…"
    }
]
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

/webhook
Medium plan or up

Create a webhook
Create a webhook, a maximum of 10 webhooks may exist at the same time.

Request body

  • Field
    Type
    Description
  • name
    string
    Name to identify the webhook
    Example: My webhook
  • url
    string
    URL to be called
    Example: https://your-server.com/example-webhook
  • disabled
    boolean
    Disable the webhook

Example

202 The webhook was successfully created. 

{
    "name": "My webhook",
    "url": "https://your-server.com/example-webhook",
    "disabled": false
}
  • Field
    Type
    Description
  • name
    string
    The name of the webhook
    Example: My webhook
  • url
    string
    The url of the webhook to be called
    Example: https://your-server.com/example-webhook
  • hmacSecret
    string
    The secret to be used to generate the HMAC token send along with the request. The secret will only be shown once upon creation, so make sure to save it after creation.
    Example: gmuNr1obKyct6FOXj6TCHTinJthlbo44
  • disabled
    boolean
    Whether the webhook is disabled or not, this can be done manually, but also if the webhook has failed too many days in a row.
  • createdAt
    string
    The date and time the webhook was created.
    Example: 2025-10-01T20:00:00Z
  • lastTriggeredAt
    string
    The last date and time the webhook was triggered. This can also be a manually trigger.
    Example: 2025-10-08T06:00:00Z 
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
-d "{\"name\":\"My webhook\",\"url\":\"https://your-server.com/example-webhook\",\"disabled\":false}"
https://api.kbodata.app/v2/webhook
{
    "name": "My webhook",
    "url": "https://your-server.com/example-webhook",
    "hmacSecret": "gmuNr1obKyct6FOXj6TCHTinJthlbo44",
    "disabled": false,
    "createdAt": "2025-10-01T20:00:00Z",
    "lastTriggeredAt": "2025-10-08T06:00:00Z"
}
HTTP/1.1 202 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

/webhook/{webhookId}
Medium plan or up

Get an existing webhook

Example

200 Successful response

  • Field
    Type
    Description
  • name
    string
    The name of the webhook
    Example: My webhook
  • url
    string
    The url of the webhook to be called
    Example: https://your-server.com/example-webhook
  • hmacSecret
    string
    The secret to be used to generate the HMAC token send along with the request. The secret will only be shown once upon creation, so make sure to save it after creation.
    Example: gmuNr1obKyct6FOXj6TCHTinJthlbo44
  • disabled
    boolean
    Whether the webhook is disabled or not, this can be done manually, but also if the webhook has failed too many days in a row.
  • createdAt
    string
    The date and time the webhook was created.
    Example: 2025-10-01T20:00:00Z
  • lastTriggeredAt
    string
    The last date and time the webhook was triggered. This can also be a manually trigger.
    Example: 2025-10-08T06:00:00Z 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/webhook/{webhookId}
{
    "name": "My webhook",
    "url": "https://your-server.com/example-webhook",
    "hmacSecret": "gmuNr1obKyct6FOXj6TCHTinJthlbo44",
    "disabled": false,
    "createdAt": "2025-10-01T20:00:00Z",
    "lastTriggeredAt": "2025-10-08T06:00:00Z"
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

/webhook/{webhookId}
Medium plan or up

Update an existing webhook

Request body

  • Field
    Type
    Description
  • name
    string
    Name to identify the webhook
    Example: My webhook
  • url
    string
    URL to be called
    Example: https://your-server.com/example-webhook
  • disabled
    boolean
    Disable the webhook

Example

200 Successful response, the webhook is updated 

{
    "name": "My webhook",
    "url": "https://your-server.com/example-webhook",
    "disabled": false
}
  • Field
    Type
    Description
  • name
    string
    The name of the webhook
    Example: My webhook
  • url
    string
    The url of the webhook to be called
    Example: https://your-server.com/example-webhook
  • hmacSecret
    string
    The secret to be used to generate the HMAC token send along with the request. The secret will only be shown once upon creation, so make sure to save it after creation.
    Example: gmuNr1obKyct6FOXj6TCHTinJthlbo44
  • disabled
    boolean
    Whether the webhook is disabled or not, this can be done manually, but also if the webhook has failed too many days in a row.
  • createdAt
    string
    The date and time the webhook was created.
    Example: 2025-10-01T20:00:00Z
  • lastTriggeredAt
    string
    The last date and time the webhook was triggered. This can also be a manually trigger.
    Example: 2025-10-08T06:00:00Z 
curl -X PUT \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
-d "{\"name\":\"My webhook\",\"url\":\"https://your-server.com/example-webhook\",\"disabled\":false}"
https://api.kbodata.app/v2/webhook/{webhookId}
{
    "name": "My webhook",
    "url": "https://your-server.com/example-webhook",
    "hmacSecret": "gmuNr1obKyct6FOXj6TCHTinJthlbo44",
    "disabled": false,
    "createdAt": "2025-10-01T20:00:00Z",
    "lastTriggeredAt": "2025-10-08T06:00:00Z"
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

/webhook/{webhookId}
Medium plan or up

Delete a webhook
This will delete the webhook and all its subscriptions.

Example

204 The webhook is successfully deleted 

curl -X DELETE \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/webhook/{webhookId}
HTTP/1.1 204 OK

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

/webhook/{webhookId}/trigger
Medium plan or up

Manually trigger a webhook
Manually trigger a webhook, a set of maximum 10 random entity subscriptions will be send to the webhook url. It might take up to a minute before the webhook is called.

Example

202 Webhook is scheduled to be triggered. 

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/webhook/{webhookId}/trigger
HTTP/1.1 202 OK

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

/webhook/{webhookId}/hmac-secret
Medium plan or up

Regenerate HMAC secret
This will regenerate the secret for HMAC token generation, to verify the webhook contents at the server.

Example

200 Successful response

The HMAC secret has been regenerated.
  • Field
    Type
    Description
  • name
    string
    The name of the webhook
    Example: My webhook
  • url
    string
    The url of the webhook to be called
    Example: https://your-server.com/example-webhook
  • hmacSecret
    string
    The secret to be used to generate the HMAC token send along with the request. The secret will only be shown once upon creation, so make sure to save it after creation.
    Example: gmuNr1obKyct6FOXj6TCHTinJthlbo44
  • disabled
    boolean
    Whether the webhook is disabled or not, this can be done manually, but also if the webhook has failed too many days in a row.
  • createdAt
    string
    The date and time the webhook was created.
    Example: 2025-10-01T20:00:00Z
  • lastTriggeredAt
    string
    The last date and time the webhook was triggered. This can also be a manually trigger.
    Example: 2025-10-08T06:00:00Z 
curl -X PATCH \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/webhook/{webhookId}/hmac-secret
{
    "name": "My webhook",
    "url": "https://your-server.com/example-webhook",
    "hmacSecret": "gmuNr1obKyct6FOXj6TCHTinJthlbo44",
    "disabled": false,
    "createdAt": "2025-10-01T20:00:00Z",
    "lastTriggeredAt": "2025-10-08T06:00:00Z"
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

/webhook/{webhookId}/subscriptions
Medium plan or up

Get a list of all entity subscriptions.

Parameters Query

  • Field
    Type
    Description
  • page
    integer
    The page of the results that should be returned
    Example: 1

Example

200 Successful response

A paginated list of all webhook entity subscriptions
  • Field
    Type
    Description
  • WebhookSubscriptions
    array
  • entityNumber
    string
    The entity number of the subscription
    Example: 0200065765
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/webhook/{webhookId}/subscriptions
{
    "WebhookSubscriptions": [
        {
            "entityNumber": "0200065765"
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

/webhook/{webhookId}/subscriptions
Medium plan or up

Add webhook entity subscriptions
Bulk add entity subscriptions to a webhook. If an enterprise number or establishment number does not exists, an error will be thrown. If the entity number is already subscribed, it will silently be ignored. A maximum of 500 entity numbers are allowed at once.

Request body

  • Field
    Type
    Description
  • entityNumbers
    array
  • []
    string
    Example: 0123456789

Example

204 The webhook subscriptions have successfully been added. 

{
    "entityNumbers": [
        "0200065765",
        "0200068636",
        "0200171970",
        "0200245711",
        "0200305493"
    ]
}
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
-d "{\"entityNumbers\":[200065765,200068636,200171970,200245711,200305493]}"
https://api.kbodata.app/v2/webhook/{webhookId}/subscriptions
HTTP/1.1 204 OK

422 A validation error occurred

One or more entity numbers probably do not exist. 
[
    {
        "message": "Invalid entity numbers has been provided",
        "field": "entityNumber",
        "type": "ValidationFailed",
        "code": 422,
        "metadata": {
            "invalidIndexes": [
                6
            ]
        }
    },
    {
        "…": "…"
    }
]

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

/webhook/{webhookId}/subscriptions
Medium plan or up

Delete webhook entity subscriptions
Bulk delete entity subscriptions from a webhook. A maximum of 500 entity numbers are allowed at once.

Request body

  • Field
    Type
    Description
  • entityNumbers
    array
  • []
    string
    Example: 0123456789
  • all
    boolean
    This will remove all the subscriptions from the webhook
    Example: 1

Example

204 The provided entity numbers have been removed 

{
    "entityNumbers": [
        "0200065765",
        "0200068636",
        "0200171970",
        "0200245711",
        "0200305493"
    ]
}
curl -X DELETE \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
-d "{\"entityNumbers\":[200065765,200068636,200171970,200245711,200305493]}"
https://api.kbodata.app/v2/webhook/{webhookId}/subscriptions
HTTP/1.1 204 OK

204 All subscriptions have been successfully removed 

{
    "all": true
}
curl -X DELETE \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
-d "{\"all\":true}"
https://api.kbodata.app/v2/webhook/{webhookId}/subscriptions
HTTP/1.1 204 OK

422 A validation error occurred

One or more entity numbers probably do not exist. 
[
    {
        "message": "Invalid entity numbers has been provided",
        "field": "entityNumber",
        "type": "ValidationFailed",
        "code": 422,
        "metadata": {
            "invalidIndexes": [
                6
            ]
        }
    },
    {
        "…": "…"
    }
]

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

/webhook/{webhookId}/events
Medium plan or up

Get webhook request event logs
Get a list of triggered events for a specific webhook. Webhook logs are stored for a maximum of 1 month.

Example

200 Successful response

List of webhook log items
  • Field
    Type
    Description
  • WebhookEvents
    array
  • url
    string
    The url of the called webhook
    Example: https://your-server.com/example-webhook
  • entityNumbers
    object
    Metadata of entity numbers triggered
  • retryCount
    number
    Number of times the webhook has been retried
    Example: 1
  • responseCode
    integer
    The last returned response code
    Example: 204
  • createdAt
    string
    The date and time the webhook request was called.
    Example: 2025-10-01T20:00:00Z
  • updatedAt
    string
    The last date and time the webhook was triggered.
    Example: 2025-10-08T06:00:00Z
  • Pagination
    object
  • limit
    integer
    The used pagination limit, by default the maximum limit allowed by your plan
    Example: 10
  • page
    integer
    The current page
    Example: 1
  • totalPages
    integer
    The number of pages
    Example: 99
  • totalItems
    integer
    The total number of items in the source data
    Example: 1234
  • countItems
    integer
    The number of items in the current request
    Example: 8
  • estimate
    boolean
    If true, the number of total items is based on a quick scan. The total item count may vary if the next page is requested.
    Example: 1 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/webhook/{webhookId}/events
{
    "WebhookEvents": [
        {
            "url": "https://your-server.com/example-webhook",
            "entityNumbers": [],
            "retryCount": 1,
            "responseCode": 204,
            "createdAt": "2025-10-01T20:00:00Z",
            "updatedAt": "2025-10-08T06:00:00Z"
        },
        {
            "…": "…"
        }
    ],
    "Pagination": {
        "limit": 10,
        "page": 1,
        "totalPages": 99,
        "totalItems": 1234,
        "countItems": 8,
        "estimate": true
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

404 Item or resource not found

The item or resource specified could not be found
{
    "type": "RequestException",
    "error": "The item specified could not be found",
    "code": -2
}

Customer

/me

Get authorized customer information
Please note that this endpoint is rate limited to once per 60 seconds, if this is exceeded you'll receive a 429 response, and have to wait another 60 seconds before a valid response is returned.

Example

200 Success response

The provided authorization token is valid.
  • Field
    Type
    Description
  • Customer
    object
  • name
    string
    The username of the authorized customer
    Example: My Company Ltd.
  • planName
    string
    Active plan name This field is deprecated, use the Plan.name field instead.
    Example: Small
  • dateCreated
    string
    The date the customer is created
    Example: 2020-02-02 02:02:02
  • webhookSubscriptionUsage
    number
    The current webhook subscription usage.
    Example: 300
  • requestUsage
    number
    The current request usage.
    Example: 7800
  • requestSearchUsage
    number
    The current search request usage.
    Example: 2400
  • Plan
    object
    The currently active plan of the customer
  • name
    string
    The customer active plan name
    Example: Small
  • maxRequest
    number
    The maximum allowed request usage
    Example: 1500
  • maxRequestSearch
    number
    The maximum allowed search request usage
    Example: 500
  • maxWebhookSubscriptions
    number
    The maximum allowed webhook subscriptions
    Example: 400
  • maxPagination
    number
    The maximum results that will be returned for a paginated request
    Example: 25
  • ApiAccessToken
    object
  • isSandbox
    boolean
    API-token type
  • description
    string
    The customer defined description of the token
    Example: My custom token
  • dateCreated
    string
    Example: 2020-02-02 02:02:02
  • dateExpiration
    string
    Example: 2021-02-02 02:02:02 
curl -X GET \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/me
{
    "Customer": {
        "name": "My Company Ltd.",
        "planName": "Small",
        "dateCreated": "2020-02-02 02:02:02",
        "webhookSubscriptionUsage": 300,
        "requestUsage": 7800,
        "requestSearchUsage": 2400,
        "Plan": {
            "name": "Small",
            "maxRequest": 1500,
            "maxRequestSearch": 500,
            "maxWebhookSubscriptions": 400,
            "maxPagination": 25
        }
    },
    "ApiAccessToken": {
        "isSandbox": false,
        "description": "My custom token",
        "dateCreated": "2020-02-02 02:02:02",
        "dateExpiration": "2021-02-02 02:02:02"
    }
}
HTTP/1.1 200 OK
Content-Type: application/json
X-Environment: production
X-API-Request-Cost: 1
X-API-Request-Count: 124
X-API-Request-Limit: 1000
X-API-Search-Request-Cost: 1
X-API-Search-Request-Count: 794
X-API-Search-Request-Limit: 1000

401 Invalid authorization token provided 

{
    "error": "The provided access token is invalid",
    "type": "AuthorizationException",
    "code": -2
}

429 Too many requests

You have exceeded the rate limit for this endpoint. Consult the `Retry-After` response header after how many seconds you may retry the request again.
{
    "error": "You have exceeded the rate limit for this endpoint, try again in 60 seconds",
    "type": "HttpTooManyRequestsException",
    "code": 429
}

Health

/health

Health check for the API
Check the health of the API, every 2xx status code should be considered healthy, and every 5xx status code should be considered unhealth. Please note that this endpoint is rate limited to once per 60 seconds, if this is exceeded you'll receive a 429 response, and have to wait another 60 seconds before a valid response is returned.

Example

204 Success response

The API is healthy
curl -X OPTIONS \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/health
HTTP/1.1 204 OK

500 The API in unhealthy

503 The API is unhealthy

429 Too many requests

You have exceeded the rate limit for this endpoint. Consult the `Retry-After` response header after how many seconds you may retry the request again.
{
    "error": "You have exceeded the rate limit for this endpoint, try again in 60 seconds",
    "type": "HttpTooManyRequestsException",
    "code": 429
}

405 Invalid method

Make sure the request is an OPTIONS method

/health/vat

Health check for the VAT endpoints
Check the health of the VAT endpoints, every 2xx status code should be considered healthy, and every 5xx status code should be considered unhealth. Please note that this endpoint is rate limited to once per 60 seconds, if this is exceeded you'll receive a 429 response, and have to wait another 60 seconds before a valid response is returned. Endpoints include:
- /vat/{vatNumber}

Example

204 Success response

The VAT endpoints are healthy.
curl -X OPTIONS \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/health/vat
HTTP/1.1 204 OK

500 The VAT service in unhealthy

503 The VAT service is unhealthy

429 Too many requests

You have exceeded the rate limit for this endpoint. Consult the `Retry-After` response header after how many seconds you may retry the request again.
{
    "error": "You have exceeded the rate limit for this endpoint, try again in 60 seconds",
    "type": "HttpTooManyRequestsException",
    "code": 429
}

405 Invalid method

Make sure the request is an OPTIONS method

/health/nsso

Health check for the NSSO endpoints
Check the health of the VAT endpoints, every 2xx status code should be considered healthy, and every 5xx status code should be considered unhealth. Please note that this endpoint is rate limited to once per 60 seconds, if this is exceeded you'll receive a 429 response, and have to wait another 60 seconds before a valid response is returned. Endpoints include:
- /enterprise/{enterpriseNumber}/nsso

Example

204 Success response

The NSSO endpoints are healthy
curl -X OPTIONS \
-H "Content-Type: application/json" \
-H "Authorization: Bearer tk9xkS0PrDpa1yxIT6WWwD204c3pgOe8fIpguPCeGGzZ2ufRU5F74lMW1ap111g7" \
https://api.kbodata.app/v2/health/nsso
HTTP/1.1 204 OK

500 The NSSO service is unhealthy.

503 The NSSO service is unhealthy.

429 Too many requests

You have exceeded the rate limit for this endpoint. Consult the `Retry-After` response header after how many seconds you may retry the request again.
{
    "error": "You have exceeded the rate limit for this endpoint, try again in 60 seconds",
    "type": "HttpTooManyRequestsException",
    "code": 429
}

405 Invalid method

Make sure the request is an OPTIONS method

Webhooks

Webhooks allow you to receive real-time HTTP notifications of changes to your data. When an event is triggered, we send an HTTP POST request to the URL you have specified for your webhook. This request contains a payload with information about the event.

You can use webhooks to automate workflows, update your database, or notify users of important events.

Webooks are available since version 2.6 for customers using the Medium plan and up.

Subscriptions

To start receiving webhooks, you need to create a webhook subscription. You can do this by sending a POST request to the /webhooks/subscriptions endpoint.

This must be either be a valid enterprise or establishment number, and it must be active. It's not possible to subscribe to inactive enterprises or establishments.

Depending on your plan, there might be a limit on the number of webhook subscriptions you can create.

Events

When an enterprise or establishment has changes, and you are subscribed to it, we will trigger a webhook event the next day.

You cannot subscribe to an inactive enterprise or establishment, entities that will change its status from active to inactive will receive an event, but after that the subscription will become invalid.

We currently do not provide which information has been changed, this maybe anything of the following information: entity details, status, juridical- situation and form, financial information, addresses, denominations, contact information, dates, NACE activities, function and roles. In case any information about an establishment changes, this will also trigger a webhook on the enterprise.

You will receive the changed entity numbers in the payload of the request, based on these numbers you can request the new information and update your data.

Note: These information changes will not trigger a webhook: VAT-number validity changes and NSSO information. If these records are important for you to be up-to-date, you should still check them periodically.

Retries

It may happen that a webhook delivery fails, in example when your server or network is down and we could not reach is.

In such cases, we will retry sending the webhook according to the following schedule:

Retry attempt Delay before next attempt
1 10 minutes
2 60 minutes
3 2 hours
4 4 hours
5 8 hours
6 24 hours
7 48 hours
8 72 hours

Note that after 8 failed attempts (so 72 hours or 3 days), we will stop trying to re-execute the webhook event and it's payload. The webhook will be disabled completely, and not triggering any new entity changes.

If necessary, you can always change the webhook URL and re-enable the webhook, without losing any existing subscriptions.

Incoming request

/example-webhook

Request headers

  • Header
    Type
    Description
  • Content-Length
    integer
    Length of the JSON request body.
    Example: 4345
  • Content-Type
    string
    The content type of the request body, will always be application/json.
    Example: application/json
  • Content-Digest
    string
    The SHA-256 calculated hash of the request body.
    Example: sha-256=:f9a4ecea08365468226ab7584e6ca1a981b25660fd31eddffe209764cc413af8:
  • Date
    string
    Date of the request.
    Example: Tue, 16 Dec 2025 16:56:32 GMT
  • X-Webhook-Id
    number
    The ID of the webhook that triggered the event.
    Example: 342424
  • X-Webhook-Event-Id
    number
    The ID of the webhook event.
    Example: 432433
  • X-Webhook-Created-At
    string
    The original creation date of the webhook event, incase of a retry this value will stay the same.
    Example: 2025-12-16T16:56:32+00:00
  • X-Webhook-Signature
    string
    The calculated HMAC-SHA256 hash of the request body with the webhook secret. Use this hash to verify if the contents really came from our server. The hash is encoded using Base64.
    Example: HMAC-SHA256 YTIzZDgwYjM0ZjE2NjFiZjk2ODQ5NDJhNDg5NTlkZWY=
  • X-Attempt-Count
    number
    Number of attemts to deliver the webhook, first time will be 1.
    Example: 1
  • X-Attempt-Count-Max
    number
    The maximum numbers of retries will be executed for this webhook event.
    Example: 9

Request body

Enterprises and establishment that have changes. The meta data will be an empty object `{}` for now, in the future we might use this to provide more details information about what has been changed at the entity.

  • Field
    Type
    Description
  • enterprises
    object
  • establishments
    object

Request example

{
    "enterprises": {
        "0200245711": [],
        "0202395745": [],
        "0206621678": [],
        "0207087872": [],
        "0200171970": []
    },
    "establishments": {
        "2543435223": [],
        "2543435220": [],
        "2543435221": []
    }
}

Sandbox environment

The sandbox environment replaces the old limited development environment. It's indented for a test- or development-environment and provides fictional data for various scenarios.

This does not require an active subscription, so it can be used to test before going live. However, if you don't have a subscription the validity of a token will be limited to one month, for subscribers you can create a token for one year.

All functionalities, except for webhooks, from all plans are available, so keep this in mind when you are aiming for a specific subscription.

In the sections below you'll find enterprises, establishment and search terms you can use the sandbox-requests.

Make sure you use a sandbox-token and the url of the sandbox environment (kbodata.io, not kbodata.app).

GET https://api.kbodata.io/v2/

Rate limiting

The sandbox environment is limited to 30 requests per second and 1.000 per day, this limit cannot be reset by our team, so choose your requests wisely.

The headers below will be returned in every request to check your current usage. This only applies to the sandbox environment, the production environment will use different headers.

  • Name
    Type
    Description
  • X-RateLimit-Minute-Remaining
    int
  • X-RateLimit-Minute-Reset
    timestamp
  • X-RateLimit-Day-Remaining
    int
  • X-RateLimit-Day-Reset
    timestamp

Enterprise examples

For the enterprises fictional numbers will be used between 7.000.000.000 and 7.999.999.999 so they don't conflict with real enterprise numbers.

The VAT validation endpoint will also return a fictional validity result based on the VAT-status below.

Establishment examples

For the establishments fictional numbers will be used between 8.000.000.000 and 8.999.999.999 so they don't conflict with real establishment numbers.

Search keyword examples

Denominations

Keyword Description
Solar
Tech
Bouw
Consulting
Food
Transport

Addresses

Keyword Description
Laan Avenue/Lane, common in Dutch street names
Straat Street, very common in Dutch street names
Weg Road or way, common in Dutch street names
Rue Street, common in French
Plein Square/Plaza in Dutch
Avenue Also avenue in English, common for French streets

Other examples

Nace codes

These NACE codes are available in the sandbox environment:

Roles

Code Name
1 Director
2 Person in charge of daily management
5 Manager
6 Managing Director
11 Secretary / Managing director
12 Founder registered entity natural person
15 Curator (designated by court)
16 Property manager

Juridical forms

Code Name
000 Natural person
008 Cooperative society with limited liability
011 General partnership
014 Public limited company
015 Private limited liability company
017 Non-profit organisation
026 Private foundation
030 Foreign entity

Juridical situations

Code Name
000 Normal situation
001 Legal incorporation
010 Ex officio dissolution
014 Closure of liquidation
050 Opening of bankruptcy procedure
053 Closing of bankruptcy procedure
100 Entity identification

Responses

HTTP status codes

By looking at the HTTP response code, you can see if the request was successful or not. If the request was unsuccessful, you can usually use the HTTP response code and the error message in the JSON-response to find out what went wrong. You probably need change something in the request parameters.

Below is a list of common HTTP response codes, used in our API:

  • 200 OK
    Success The request was successful and the data can be used.
  • 401 Unauthorized
    Not authorized You will retrieve this status code if the authorization fails, possible by using an incorrect username or access token.
  • 402 Payment Required
    Means that your plan has expired and needs renewal. You can do this on your dashboard.
  • 404 Not Found
    Will be returned if the specific item requested, cannot be found. Also used when an endpoint doesn't exist, but the API-token is valid.
  • 405 Method Not Allowed
    The used request method is unaccepted, in example this will be returned when the requested method is POST, but should be a GET.
  • 409 Conflict 422 Unprocessable Entity
    Incorrect or missing parameters The requested request could not be processed, usually due missing required parameters or parameters that contain an incorrect format.
  • 429 Too Many Requests
    Request limit exceeded You have exceeded the maximum number of requests for this period, wait until for a limit reset at the end of your period or upgrade your subscription plan. You can do this on your dashboard.