/v1/company-checks
Perform a company check through its Chamber of Commerce (CoC) number.
Body·
required
application/json
- Type: string enumtyperequiredvalues
- basic
- basic
_plus - standard
- extended
- kvk
- mkb
- ubo
- custom
- compliance
- Type: stringchamber
_of _commerce _number - Type: stringcheck
_identifier - Type: object ·company
- Type: stringreport
_language - Type: booleanreport
_view - Type: stringsearch
_identifier - Type: object ·source
- Type: stringvat
_number
Responses
- application/json
- application/json
Request Example for post/v1/company-checks
curl https://api.test.24idcheck.com/v1/v1/company-checks \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic username:password' \
--data '{
"type": "basic",
"report_language": "",
"report_view": true,
"check_identifier": "",
"search_identifier": "",
"source": {
"source": "",
"sourceid": "",
"organisation_name": "",
"organization_coc_registration_number": "",
"username": "",
"userid": 1,
"location": "",
"location_id": ""
},
"chamber_of_commerce_number": "",
"company": {
"name": "",
"address": {
"street": "",
"house_number": "",
"house_number_extension": "",
"zip_code": "",
"city": "",
"country": "",
"address_line_1": "",
"address_line_2": "",
"state": ""
},
"mail_address": "",
"phone_number": ""
},
"vat_number": ""
}'
{
"check_identifier": "string",
"report_identifier": "string",
"company": {
"status": "active",
"name": "string",
"type": "string",
"address": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"address_line_1": "string",
"address_line_2": "string",
"state": "string"
},
"post_address": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"address_line_1": "string",
"address_line_2": "string",
"state": "string"
},
"mail_address": "string",
"phone_number": "string",
"industry": "string",
"industry_description": "string",
"business_entity_type": "string",
"incorporation_date": "2026-09-01T09:30:28.784Z",
"incorporation_year": "string",
"chamber_of_commerce_number": "string",
"directors": [
{
"name": "string",
"initials": "string",
"first_name": "string",
"last_name_prefix": "string",
"last_name": "string",
"chamber_of_commerce_number": "string",
"company": "Ja",
"gender": "M",
"date_of_birth": "2026-09-01",
"address_of_birth": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"address_line_1": "string",
"address_line_2": "string",
"state": "string"
},
"risk": {
"code": "0",
"description": "string"
},
"address_match": {
"code": "string",
"message": "string",
"last_updated": "2026-09-01T09:30:28.784Z",
"address": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"address_line_1": "string",
"address_line_2": "string",
"state": "string"
}
},
"function_date": "2026-09-01",
"authority": "string"
}
],
"parents": [
{
"name": "string",
"shareholding_percentage": 1,
"start_date": "2026-09-01",
"address": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"address_line_1": "string",
"address_line_2": "string",
"state": "string"
},
"mail_address": "string",
"phone_number": "string",
"industry": "string",
"industry_description": "string",
"business_entity_type": "string",
"incorporation_year": "string",
"chamber_of_commerce_number": "string",
"directors": [
{
"name": "string",
"initials": "string",
"first_name": "string",
"last_name_prefix": "string",
"last_name": "string",
"chamber_of_commerce_number": "string",
"company": "Ja",
"gender": "M",
"date_of_birth": "2026-09-01",
"address_of_birth": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"address_line_1": "string",
"address_line_2": "string",
"state": "string"
},
"risk": {
"code": "0",
"description": "string"
},
"address_match": {
"code": "string",
"message": "string",
"last_updated": "2026-09-01T09:30:28.784Z",
"address": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"address_line_1": "string",
"address_line_2": "string",
"state": "string"
}
},
"function_date": "2026-09-01",
"authority": "string"
}
],
"parents": []
}
],
"ubo": [
{
"name": "string",
"roles": [
{
"id": "string",
"type": "string",
"competency": "string",
"start_date": "2026-09-01T09:30:28.784Z"
}
],
"tree": {
"level": 1,
"id": "string",
"type": "string",
"role": "string",
"name": "string",
"parents": [
{
"level": 1,
"id": "string",
"type": "string",
"role": "string",
"name": "string",
"parents": []
}
]
},
"person": {
"initials": "string",
"first_name": "string",
"last_name_prefix": "string",
"last_name": "string",
"mail_address": "string",
"gender": "M",
"date_of_birth": "2026-09-01T09:30:28.784Z",
"place_of_birth": "string",
"phone_number": "string"
},
"shareholding_percentage": 1
}
],
"company_balance_sheet": {
"entries": [
{}
],
"parent_entries": [
{}
]
},
"search_identifier": "string"
},
"financial_info": {
"risk_rating": {
"code": "BRR1",
"message": "string"
},
"payment_behavior": {
"code": "BBG1",
"message": "string",
"term": "string"
},
"payment_behavior_norm": {
"code": "BBG1",
"message": "string",
"term": "string"
},
"payment_behavior3_months_ago": {
"code": "BBG1",
"message": "string",
"term": "string"
},
"equity": "string",
"cash": "string",
"credit_guide": "string",
"issued_share_capital": "string",
"paid_up_share_capital": "string"
},
"risk_country": {
"risk_result": "L"
},
"claims": [
{
"receivedDate": "string",
"durationDays": "string",
"claimAmount": "string",
"paidAmount": "string",
"closed": "string",
"legalAction": "string",
"disputed": "string",
"foreign": "string"
}
],
"registrations": [
{
"source": "string",
"match": "string",
"description": "string"
}
],
"registrations_extended": {
"summaries": [
{
"person": 1,
"company_name": 1,
"company_kvk": 1,
"address": 1,
"id_document": 1,
"source": "string",
"PoliticallyExposed": 1,
"pepCompany": 1,
"AdverseMedia": 1,
"DisqualifiedDirector": 1,
"LawEnforcement": 1,
"Sanctions": 1,
"CurrentSanctions": 1,
"PreviousSanctions": 1,
"FinancialRegulator": 1,
"Insolvent": 1
}
],
"registrations": [
{
"source": "string",
"match": "string",
"description": "string"
}
]
},
"vat_validation": {
"result": "Valid",
"result_description": "string",
"company": "string",
"address": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"address_line_1": "string",
"address_line_2": "string",
"state": "string"
},
"vat_number": "string"
},
"backend_data": "string",
"request_parameters": {
"identifier": "string",
"company": {
"name": "string",
"chamber_of_commerce_number": "string",
"vat_number": "string",
"address": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"state": "string"
}
},
"address": {
"street": "string",
"house_number": "string",
"house_number_extension": "string",
"zip_code": "string",
"city": "string",
"country": "string",
"state": "string"
},
"ids": {
"kvk": "string",
"btw": "string"
}
},
"report_pdf": "string",
"report_html": "string"
}