Send Company Record

After registering a new company, send the company record with the formatted registration data to Concedus to start the onboarding process. The format and structure of the customer data is documented under Data Format. We then provide you with verification links for every person in the company from the selected KYC provider that the persons can use to start the verification process. When all verifications are completed, we send you the result in the form of a compliance record. Depending on the result, you can take further action.

Company onboarding process

API Method

Customers and companies are imported with the same endpoint.

To distinguish these two types of records, set the field customers.person.type as follows:

  • "0" = customer

  • "1" = company

Import customer as company with roles

POST https://demo2.api.concedus.com/v2/compliance/contacts

Headers

Name
Type
Description

Content-Type*

String

application/json or application/zip

Authorization*

String

Bearer token

Request Body

Name
Type
Description

customers*

json

See: JSON structure

{
  "identLinks": [
    {
      "kyc": "IDNOW",
      "url": "https://verify.idnow.com/demo/0029993384",
      "key": "PERSON_f627b484-15e8-42b7-99cc-9cfa5011766e",
      "actionId": "0029993384"
    }
  ]
}

Data Format

  • JSON is transmitted when no other attachments are transmitted in file form. (default)

  • ZIP must be sent if attachments are to be transferred as well. This is usually not required for company imports and is agreed upon in advance if necessary.

JSON structure

Company example
{
    "customers": [
        {
            "person": {
                "type": 1,
                "professionell": {
                   "equity":true,
                   "revenue":true,
                   "balance":true,
                   "assets":false,
                   "experience":true,
                   "transactions":true
                },
                "precheckPep": "False",
                "foundingDate": "2013-02-23",
                "registryNumber": "BR22569915",
                "registryCourt": "Schongau",
                "legalForm": "KG",
                "taxId": "DE863086",
                "companyName": "Renner",
                "street": "Andrea-Reinhardt-Platz 85",
                "zip": "16612",
                "city": "Ilmenau",
                "country": "DE",
                "bankAccounts": [
                    {
                        "accountHolder": "Fechner, Kurt",
                        "bic": "SWKUDECFRUS",
                        "iban": "DE55824412653968951813",
                        "bank": "Commerzbank",
                        "country": "DE",
                        "currency": "EUR",
                        "sharedAccount": false,
                        "key": "BA_c03577aa-8f7c-412d-ada3-5c7df786fae3",
                        "modified": "2023-03-27T16:22:40"
                    }
                ],
                "subPersons": [
                    {
                        "role": 70,
                        "person": {
                            "type": 0,
                            "precheckPep": "True",
                            "salutation": "Herr",
                            "foreName": "Kurt",
                            "surName": "X-MANUALTEST-HAPPYPATH",
                            "street": "Aumannstraße 0",
                            "zip": "00746",
                            "city": "Mettmann",
                            "country": "DE",
                            "birthDate": "1997-12-23",
                            "birthPlace": "Eggenfelden",
                            "birthCountry": "DE",
                            "emailPriv": "[email protected]",
                            "nationality": "DE",
                            "furtherNationalities": [
                                "DO"
                            ],
                            "email": "[email protected]",
                            "mobile": "+490193265780223",
                            "phone": [
                                "+498744252847115"
                            ],
                            "web": "www.kurt-fechner.de",
                            "bankAccounts": [
                                {
                                    "accountHolder": "Fechner, Kurt",
                                    "bic": "UIVDDEHI",
                                    "iban": "DE02106013318112410581",
                                    "bank": "Deutsche Bank",
                                    "country": "DE",
                                    "currency": "EUR",
                                    "sharedAccount": true,
                                    "type": "0",
                                    "key": "BA_65c8a74a-1aa4-49b6-a4cf-f9bd4a6cbf93",
                                    "modified": "2023-03-27T16:22:40"
                                }
                            ],
                            "customFields": [
                                {
                                    "name": "KYC",
                                    "value": "IDNOW"
                                }
                            ],
                            "key": "PERS_522a20d0-afa0-4751-83c0-4b2d7e0e14a1",
                            "modified": "2023-03-27T16:22:40"
                        }
                    }
                ],
                "key": "RAND_3890be01-00da-49e9-8817-3c447688d5fc",
                "modified": "2023-03-27T16:22:40"
            },
            "investmentSurveys": [
                {
                    "investmentExperience": [
                        {
                            "type": 0,
                            "knowledge": true
                        },
                        {
                            "type": 3,
                            "knowledge": true
                        },
                        {
                            "type": 4,
                            "knowledge": false
                        },
                        {
                            "type": 5,
                            "knowledge": false
                        },
                        {
                            "type": 8,
                            "knowledge": false
                        },
                        {
                            "type": 10,
                            "knowledge": false
                        }
                    ],
                    "investorExperience": [
                        {
                            "name": "AE1",
                            "value": "1"
                        },
                        {
                            "name": "AE2",
                            "value": "3"
                        },
                        {
                            "name": "AE5",
                            "value": "1"
                        },
                        {
                            "name": "AE7",
                            "value": "2"
                        },
                        {
                            "name": "AE8",
                            "value": "3"
                        },
                        {
                            "name": "AE6",
                            "value": "1"
                        },
                        {
                            "name": "AE4",
                            "value": "2"
                        },
                        {
                            "name": "AE3",
                            "value": "3"
                        }
                    ],
                    "customFields": [
                        {
                            "name": "ForceMissedKnowledge",
                            "value": "true"
                        }
                    ],
                    "key": "INVST_58a4288b-210c-4ef7-8654-e77062d5d00c",
                    "modified": "2023-03-27T16:22:40"
                }
            ],
            "events": [],
            "key": "CUSTO_bd3c77e2-1cdf-480a-ab17-afccd79e7c79",
            "modified": "2023-03-27T16:22:40"
        }
    ]
}

Customers

Field
Type
Requirement
Description

person

object

required

See: Person

investmentSurveys

object

required

See: Investment Surveys

key

string

required

See: Key

modified

string

required

See: Modified

Person

KYC-relevant fields are indicated in red

Field
Type
Required
Description

type

number

required

1 (company)

professionell

depending on business model

See here

precheckPep

string

required

"True" if politically engaged company

foundingDate

string

required

Founding date of company

registryNumber

string

required

Registry number of company

registryNo

string

optional

if available it is required

registryCourt

string

optional

if available it is required

taxId

string

required

Tax-ID

legalForm

string

required

See: Company Codes

companyName

string

required

Name of company

street

string

required

Street name and number

zip

string

required

Postal code

city

string

required

City

country

string

required

Country code ISO-3166 AL2

email

string

optional

Business e-mail address

phone

array[string]

optional

Further phone numbers

web

string

optional

Web address

bankAccounts

object

depends on legal requirement / business case

See: Bank Accounts

subPersons

array[object]

required

All natural persons in that company (see: subPersons)

subPersons[].role

number

required

See: Company Roles

subPersons[].person

object

required

See: Person (in customer)

subPersons[].person.customFields[].name

string

required

"KYC" (to define the KYC Provider)

subPersons[].person.customFields[].value

string

required

Chosen KYC Provider (see: KYC-List)

key

string

required

See: Key

modified

string

required

See: Modified

Bank Accounts

Field
Type
Requirement
Description

accountHolder

string

required

Surname, Forename

bic

string

required

Bank identifier code

iban

string

required

International bank account number

bank

string

required

Name of the bank

country

string

required

Country code

currency

string

required

Currency code

key

string

required

See: Key

modified

string

required

See: Modified

Company Roles

Roles must be defined while importing a company with different types of participants

Please check our new section for company roles

Company Codes

Code
Description

AG

Aktiengesellschaft

eG

eingetragene Genossenschaft

GmbH

Ges. M. beschr. Haftung

GmbH_CoKG

GmbH&Co. KG

KG

Kommanditgesellschaft

Ltd

Limited Company

Stiftung

Stiftung

Events (File-Uploads)

In case you need to provide additional files, you can use the same approach as for contracts by providing files, linked by the "events" section. Please by that, provide the ZIP file in the payload (as binary). Please not add temp. or non referenced files in the Zip.

If you use events, please always provide the zip file with added header, instead of application/json:

--header 'Content-Type: application/zip'
Field
Type
Requirement
Description

date

string

required

DateTime, when the file was created

subject

string

required

individual

category

string

required

default: "Legitimation"

file

string

required

relative path to the file

key

string

required

See: Key

modified

string

required

See: Modified

Sample Documents

German Definition
subject
category

Handelsregisterauszug

CommercialRegister

Extract

Gesellschaftervertrag

ShareholdersAgreement

Contract

Liste aller Gesellschafter

ShareholdersList

Register

Transparenzregisterauszug

TransparencyRegister

Extract

Vollmachtnachweis

PowerOfAttorney

Authorization

PreviousSend Customer RecordNextCompany Roles

Last updated