A legal entity is legally allowed to perform certain economic activities. Within the KYC Suite these activities are referred to as 'legal activities'. This page describes the legal activities so that you may interact with them via the API.

External business data

When data for a legal entity within the KYC Suite is retrieved via an external source, the KYC Suite automatically fills all legal activities that were provided by the external source.

The KYC Suite offers the following external sources for legal activities:

Kamer van Koophandel + Kruispuntbank van Ondernemingen
- KvK offers support for the Netherlands with classification system SBI;
- KBO offers support for Belgium with classification system NACE
Creditsafe (additional costs)
- Offers support for multiple classification systems.

For more details on the external sources for business data, see: KYC Business data

Client File API

In the bcmd-party graphql API the legal activities are structured as a list of legalActivity objects.

type legalActivity {
    partyId: String
    code: String
    text: String
    classification: String
    userDefined: Boolean
}

input legalActivityInput {
    code:String
    text: String
    classification: String
    userDefined: Boolean
}

Example response:

"legalActivity": [
    {
        "classification": "NACE",
        "code": "0123",
        "text": "Growing of citrus fruits",
        "userDefined": false,
        "__typename": "legalActivity"
    },
    {
        "classification": "NACE",
        "code": "0123",
        "text": "Growing of citrus fruits, but customised",
        "userDefined": true,
        "__typename": "legalActivity"
    },
    {
        "classification": "SBI",
        "code": "01242",
        "text": "Teelt van steenvruchten",
        "userDefined": true,
        "__typename": "legalActivity"
    },
    {
        "classification": "CUSTOM",
        "code": "1235",
        "text": "A description within our own classification system",
        "userDefined": true,
        "__typename": "legalActivity"
    }
]

Object explanation:

Field	Description
classification `mandatory`	The classification system for this legal activity. The maximum length is 10 characters.
code `either code or text is mandatory`	Lookup code within the classification system. Can be left empty.
text `either code or text is mandatory`	Description of the legal activity within the classification system. Can be left empty.
userDefined `optional`	When a value is selected from our internal lookup table, the value should be `false`, in any other case it should be `true`.

Unique constraint: Only a unique combination of classification, code and text is accepted.

NACE Code lookup

The Blanco KYC Suite can be used to list all NACE codes available within our system. If a code from our lookup table is used and the field userDefined is set to false, the KYC Suite offers automatic translations for these legal activities in Dutch, English and French, for example when working with a multi-language user base or when generating reports in different languages.

Endpoint: GET https://api.blanco.cloud/bgc/legalActivities/{{languageCode}}

Language code options: en-US, nl-NL, fr-FR

Response: A full list of NACE codes and text in language code provided.

Example response:

[
    {
        "level": 1,
        "code": "A",
        "parentCode": "",
        "name": "AGRICULTURE, FORESTRY AND FISHING",
        "formattedCode": "A"
    },
    {
        "level": 2,
        "code": "01",
        "parentCode": "A",
        "name": "Crop and animal production, hunting and related service activities",
        "formattedCode": "01"
    },
    ...
]

Legal activities explained

Contents

External business data

Client File API

NACE Code lookup