KYB API
The KYB API lets you search for a legal entity and retrieve structured company data directly from official registers and aggregated sources. Three endpoints cover the full workflow:- Authentication (
/auth) — Obtain a Bearer token using yourApi-KeyandCustomer-Id. Required before any other call. - Search (
/kyb/search) — Find a company by name or registration number. Returns acompanyIdandtransactionIdrequired for the next step. - Company Details (
/kyb/company/details) — Retrieve the full company record. Theincludeparameter controls which data packages are returned; each package is priced separately. Document and transparency packages return a list of available items withlinkTokenvalues. - Document Retrieval (
/kyb/company/document/retrieve) — Fetch an individual document or transparency register entry using alinkTokenfrom the details response.
idcanopy). All other data is passed through as-is from the source.
Authentication
POST/auth
All KYB API requests require a Bearer token. Obtain one by calling the authentication endpoint with your credentials. Tokens are valid for 60 minutes and must be refreshed after expiration.
Required Headers
| Header | Value |
|---|---|
Content-Type | application/x-www-form-urlencoded |
Api-Key | Your API key (UUID) |
Customer-Id | Your customer ID (UUID) |
Example Request
Copy
curl -X POST https://api-umbrella.io/api/services/auth \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Api-Key: 40ab0d69-fc3e-5fea-bfa8-b94e93462ad9" \
-H "Customer-Id: 16a6c3e7-7a76-4714-9b34-97135ab4bdcd"
Response
Copy
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_in": 3600,
"token_type": "Bearer"
}
access_token value in the Authorization header of all subsequent requests:
Copy
Authorization: Bearer <access_token>
Base URLs
| Environment | URL |
|---|---|
| Production | https://api-umbrella.io/api/services |
| Sandbox | https://sandbox-umbrella-api.azurewebsites.net/api/services |
1. Search Company
POST/kyb/search
Searches for a legal entity by name (fuzzy) or registration number (exact). Exactly one of name or companyNo must be provided — not both.
Required Headers
| Header | Value |
|---|---|
Content-Type | application/json |
Authorization | Bearer <access_token> |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | XOR | Company name. Fuzzy matching is applied; quality depends on the underlying source. |
companyNo | string | XOR | Official registration number (exact match). |
country | string | Yes | ISO 3166-1 alpha-2 country code (e.g. GB, AT, DE). |
locality | string | No | City or locality to narrow results. |
name and companyNo are mutually exclusive. Providing both will return a validation error.Example Request — by name
Copy
{
"name": "IDCanopy Group Ltd",
"country": "GB",
"locality": "London"
}
Example Request — by registration number
Copy
{
"companyNo": "16262990",
"country": "GB"
}
Response
The response is an array of matches. Multiple results may be returned for name-based searches.| Field | Type | Description |
|---|---|---|
status | boolean | true on success. |
data[] | array | List of matched companies. |
data[].transactionId | string | Session token — pass to /kyb/company/details. |
data[].companyId | string | Umbrella company identifier — pass to /kyb/company/details. |
data[].name | string | Registered legal name. |
data[].status | string | Company status (e.g. active, dissolved). |
data[].registrationNumber | string | Official registration number. |
data[].addressLine | string | Registered address, single line. |
data[].country | string | ISO alpha-2 country code. |
Example Response
Example Response
Example Response
Copy
{
"status": true,
"data": [
{
"transactionId": "a8b89ef3-9d93-4d96-a495-be605fd1b2fe",
"companyId": "223c8dde-9c82-4811-ba3c-4f9fe648c2da",
"name": "IDCANOPY GROUP LTD",
"status": "active",
"registrationNumber": "16262990",
"addressLine": "71-75 Shelton Street, Covent Garden, London, United Kingdom, WC2H 9JQ",
"country": "GB"
}
]
}
2. Company Details
POST/kyb/company/details
Retrieves the full company record for a previously resolved entity. Use the transactionId and companyId returned by /kyb/search.
The include object controls which data packages are returned. Only requested packages are fetched and billed.
Required Headers
| Header | Value |
|---|---|
Content-Type | application/json |
Authorization | Bearer <access_token> |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
transactionId | string | Yes | From the search response. |
companyId | string | Yes | From the search response. |
include | object | No | Data packages to retrieve. All default to false. |
timeoutMs | integer | No | Request timeout in milliseconds. |
include Packages
| Package | Type | Description |
|---|---|---|
officers | boolean | Directors, managing partners, and authorised signatories with roles, tenure, and signature rights. |
addresses | boolean | All registered and business addresses (structured and single-line). |
ownerships | boolean | Shareholder and UBO data including holding percentages, capital, and voting rights. |
transparency | boolean | Transparency register entries. Returns a list of available entries with linkToken values for retrieval via /kyb/company/document/retrieve. |
documents | boolean | Official company documents (e.g. articles of association, register extracts). Returns a list of available documents with linkToken values for retrieval via /kyb/company/document/retrieve. |
financials | boolean | Available financial data such as balance sheet and revenue figures. |
Example Request
Copy
{
"transactionId": "a8b89ef3-9d93-4d96-a495-be605fd1b2fe",
"companyId": "223c8dde-9c82-4811-ba3c-4f9fe648c2da",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": false
}
}
Response Structure
Core Company Fields
Core Company Fields
| Field | Type | Description |
|---|---|---|
status | boolean | true on success. |
data.company.legalName | string | Official registered legal name. |
data.company.tradingNames[] | array | Trading or alternative names. |
data.company.status | string | Current status (e.g. active, dissolved). |
data.company.companyType | object | Company type with native (register text) and modeled (idcanopy scheme) values. |
data.company.incorporationDate | string | ISO 8601 incorporation date. |
data.company.registrationDate | string | ISO 8601 registration date, if available. |
data.company.country | string | ISO alpha-2 country code. |
data.company.registeredAddress.singleLine | string | Full registered address, single line. |
data.company.registeredAddress.structured | object | Structured address: line1, line2, city, postalCode, region, country. |
data.company.businessAddress | object | Business address, same structure. May be null. |
data.company.identifiers[] | array | Identifiers across schemes. Each entry: scheme (e.g. REGISTRATION_NUMBER, VAT, LEI), value, country. |
data.company.industryCodes[] | array | Industry codes: scheme (e.g. NACE), code, label. |
data.company.website | string | Official website, if available. |
metadata.confidence | number | Match confidence score (0–1). |
metadata.completeness | number | Data completeness score (0–1). |
metadata.source | string | Name of the data source (e.g. Companies House). |
metadata.sourceTst | string | ISO 8601 timestamp of source data retrieval. |
Officers (include.officers)
Officers (include.officers)
Returned under
data.company.officers[].| Field | Type | Description |
|---|---|---|
type | string | individual or company. |
officerID | string | Umbrella officer identifier. |
officerData.firstName | string | First name. |
officerData.lastName | string | Last name. |
officerData.DOB | string | Date of birth (ISO 8601). |
officerData.nationality | string | ISO alpha-2 nationality code. |
officerData.address.singleLine | string | Officer address. |
activity.role | object | Role with native and modeled values. |
activity.status | string | active or inactive. |
activity.from / activity.to | string | Tenure start and end dates. |
activity.signatureRights | object | Signatory rights with native, modeled, and signatureQuality (individual or joint). |
Ownership (include.ownerships)
Ownership (include.ownerships)
Returned under
data.company.ownership[].| Field | Type | Description |
|---|---|---|
type | string | individual or company. |
ownerID | string | Umbrella owner identifier. |
ownerData.firstName / lastName | string | Owner name. |
ownerData.address.singleLine | string | Owner address. |
ownerData.shareholding.holdingPct.shares | string | Share percentage. |
ownerData.shareholding.holdingPct.capital | string | Capital amount. |
ownerData.shareholding.holdingPct.votingRights | string | Voting rights percentage. |
ownerData.shareholding.verbalholding[] | array | Verbal holding description with native and modeled values. |
ownerData.isUBO | string | Whether the owner is a UBO (yes / no). |
Documents & Transparency (include.documents / include.transparency)
Documents & Transparency (include.documents / include.transparency)
When
documents or transparency is included, the response contains a list of available items. Pass the linkToken for each item to /kyb/company/document/retrieve to obtain the actual file.| Field | Type | Description |
|---|---|---|
type | string | Document type (e.g. excerpt, articles, transparency_entry). |
description | string | Human-readable description of the document. |
date | string | Date of the document, if available. |
linkToken | string | Opaque token used to retrieve the document. |
Example Response
Example Response
Example Response
Copy
{
"status": true,
"data":[ {
"company": {
"legalName": "IDCANOPY GROUP LTD",
"tradingNames": [],
"status": "active",
"companyType": {},
"incorporationDate": "2025-02-19T00:00:00.000Z",
"registrationDate": null,
"country": "GB",
"registeredAddress": {
"singleLine": "71-75 Shelton Street, WC2H 9JQ London, United Kingdom",
"structured": {
"line1": "71-75 Shelton Street",
"line2": null,
"city": "London",
"postalCode": "WC2H 9JQ",
"region": null,
"country": "GB"
}
},
"businessAddress": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": "GB"
}
},
"identifiers": [
{
"scheme": "REGISTRATION_NUMBER",
"value": "16262990",
"country": "GB"
}
],
"industryCodes": [],
"website": null
}
},
]
"metadata": {
"confidence": 0.85,
"completeness": 0.71,
"source": "Companies House",
"sourceTst": "2025-06-01T10:00:00.000Z"
}
}
3. Document Retrieval
POST/kyb/company/document/retrieve
Retrieves a company document or transparency register entry using a linkToken from the /kyb/company/details response.
Required Headers
| Header | Value |
|---|---|
Content-Type | application/json |
Authorization | Bearer <access_token> |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
transactionId | string | Yes | From the search response. |
companyId | string | Yes | From the search response. |
linkToken | string | Yes | Token from the documents or transparency list in the details response. |
Example Request
Copy
{
"transactionId": "a8b89ef3-9d93-4d96-a495-be605fd1b2fe",
"companyId": "223c8dde-9c82-4811-ba3c-4f9fe648c2da",
"linkToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
Response
Returns the document as a binary file stream. TheContent-Type response header reflects the file format (typically application/pdf).
linkToken values are scoped to the originating transactionId and companyId. They cannot be reused across sessions.Test Cases
The following test cases are organized by country. Each shows a search request, the response with available company IDs, and then the full company details call.GB
- Case GB-1 — Waitrose
- Case GB-2 — BM Developers
Search
Request
Request
Copy
{
"name": "Waitrose",
"country": "GB",
"locality": "London"
}
Response
Response
Copy
{
"status": true,
"data": [
{
"transactionId": "9d53e4c6-53f3-45d6-8fe4-fdb6485fcaa8",
"companyId": "35ca6d2b-a897-4604-9d2c-84889ce221a3",
"name": "WAITROSE LIMITED",
"status": "active",
"registrationNumber": "00099405",
"addressLine": "1 Drummond Gate, Pimlico, London, United Kingdom, SW1V 2QQ",
"country": "GB"
},
{
"transactionId": "9d53e4c6-53f3-45d6-8fe4-fdb6485fcaa8",
"companyId": "97d03b00-2d2b-4cc8-af37-a2d1072a8e58",
"name": "STARBUCKS COFFEE MCDONALD'S WAITROSE LIMITED",
"status": "active",
"registrationNumber": "07703544",
"addressLine": "2 Vantage Court, Tickford Street, Newport Pagnell, Buckinghamshire, MK16 9EZ",
"country": "GB"
},
]
}
Company Details — WAITROSE LIMITED
Request
Request
Copy
{
"transactionId": "9d53e4c6-53f3-45d6-8fe4-fdb6485fcaa8",
"companyId": "35ca6d2b-a897-4604-9d2c-84889ce221a3",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": true
}
}
Response
Response
Copy
{
"status": true,
"data": [
{
"company": {
"legalName": "WAITROSE LIMITED",
"tradingNames": [],
"status": "active",
"companyType": {},
"incorporationDate": "1908-09-03T00:00:00.000Z",
"registrationDate": null,
"country": "GB",
"registeredAddress": {
"singleLine": "1 Drummond Gate, SW1V 2QQ London, GB",
"structured": {
"line1": "1 Drummond Gate",
"line2": null,
"city": "London",
"postalCode": "SW1V 2QQ",
"region": null,
"country": "GB"
}
},
"businessAddress": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": "GB"
}
},
"identifiers": [
{
"scheme": "REGISTRATION_NUMBER",
"value": "00099405",
"country": "GB"
}
],
"industryCodes": [],
"website": null,
"contacts": [],
"signatureRules": {
"signatureQuality": null
},
"resources": [],
"officers": [
{
"type": "secretary",
"officerId": "230",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "CHEONG TUNG SING, Jane Christina",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": null,
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "secretary",
"language": "en",
"source": null
}
},
"status": null,
"from": "2021-11-01T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "director",
"officerId": "231",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "MOUNSEY, Andrew John",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "British",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
}
},
"status": null,
"from": "2024-09-06T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "director",
"officerId": "232",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "TARRY, Jason Mark",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "British",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
}
},
"status": null,
"from": "2024-09-12T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
}
],
"ownership": [
{
"ownerName": "John Lewis Plc",
"ownershipPercentage": null,
"natureOfControl": "ownership-of-shares-75-to-100-percent, voting-rights-75-to-100-percent, right-to-appoint-and-remove-directors",
"country": null
}
],
"relationships": {
"ultimateBeneficialOwners": [],
"transparencyRegister": [],
"familyTree": [],
"isHeadquarter": null,
"isGlobalUltimate": null,
"isDomesticUltimate": null,
"isSubsidiary": null
}
}
}
]
}
Company Details — STARBUCKS COFFEE MCDONALD’S WAITROSE LIMITED
This entity appeared in the Waitrose search above. SametransactionId, differentcompanyId.
Request
Request
Copy
{
"transactionId": "9d53e4c6-53f3-45d6-8fe4-fdb6485fcaa8",
"companyId": "97d03b00-2d2b-4cc8-af37-a2d1072a8e58",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": true
}
}
Response
Response
Copy
{
"status": true,
"data":[ {
"company": {
"legalName": "STARBUCKS COFFEE MCDONALD'S WAITROSE LIMITED",
"tradingNames": [],
"status": "active",
"companyType": {},
"incorporationDate": "2011-07-13T00:00:00.000Z",
"registrationDate": null,
"country": "GB",
"registeredAddress": {
"singleLine": "2 Vantage Court, MK16 9EZ Newport Pagnell, GB",
"structured": {
"line1": "2 Vantage Court",
"line2": "Tickford Street",
"city": "Newport Pagnell",
"postalCode": "MK16 9EZ",
"region": "Buckinghamshire",
"country": "GB"
}
},
"businessAddress": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": "GB"
}
},
"identifiers": [
{
"scheme": "REGISTRATION_NUMBER",
"value": "07703544",
"country": "GB"
}
],
"industryCodes": [],
"website": null,
"contacts": [],
"signatureRules": {
"signatureQuality": null
},
"resources": [],
"officers": [
{
"type": "director",
"officerId": "281",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "DIVINEY, John",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "Irish",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
},
"modeled": {
"value": "Director",
"scheme": "idcanopy",
"source": "modeled"
}
},
"status": null,
"from": "2018-11-29T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "corporate-secretary",
"officerId": "282",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "HP SECRETARIAL SERVICES LIMITED",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": null,
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "corporate-secretary",
"language": "en",
"source": null
}
},
"status": null,
"from": "2011-07-13T00:00:00.000Z",
"to": "2011-09-14T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "director",
"officerId": "283",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "BELL, Robbie Ian",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "British",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
},
"modeled": {
"value": "Director",
"scheme": "idcanopy",
"source": "modeled"
}
},
"status": null,
"from": "2017-09-29T00:00:00.000Z",
"to": "2018-12-20T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "director",
"officerId": "284",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "COULDRAKE, Gerald Mark",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "British",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
},
"modeled": {
"value": "Director",
"scheme": "idcanopy",
"source": "modeled"
}
},
"status": null,
"from": "2011-07-13T00:00:00.000Z",
"to": "2011-09-14T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "director",
"officerId": "285",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "MCKIE, Roderick Wallace",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "British",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
},
"modeled": {
"value": "Director",
"scheme": "idcanopy",
"source": "modeled"
}
},
"status": null,
"from": "2011-09-14T00:00:00.000Z",
"to": "2018-05-31T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "director",
"officerId": "286",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "WRIGHT, Nicholas David",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "British",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
},
"modeled": {
"value": "Director",
"scheme": "idcanopy",
"source": "modeled"
}
},
"status": null,
"from": "2011-09-14T00:00:00.000Z",
"to": "2017-09-29T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "corporate-director",
"officerId": "287",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "HP DIRECTORS LIMITED",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": null,
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "corporate-director",
"language": "en",
"source": null
}
},
"status": null,
"from": "2011-07-13T00:00:00.000Z",
"to": "2011-09-14T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
}
],
"ownership": [
{
"ownerName": "Welcome Break Group Limited",
"ownershipPercentage": null,
"natureOfControl": "ownership-of-shares-75-to-100-percent, voting-rights-75-to-100-percent, right-to-appoint-and-remove-directors, significant-influence-or-control",
"country": null
}
],
"relationships": {
"ultimateBeneficialOwners": [],
"transparencyRegister": [],
"familyTree": [],
"isHeadquarter": null,
"isGlobalUltimate": null,
"isDomesticUltimate": null,
"isSubsidiary": null
}
}
}
]
}
Search
Request
Request
Copy
{
"name": "BM Dev",
"country": "GB",
"companyNo": "15463692",
"locality": "London"
}
Response
Response
Copy
{
"status": true,
"data": [
{
"transactionId": "9d53e4c6-53f3-45d6-8fe4-fdb6485fcj5a8",
"companyId": "24689af7-f971-4ccd-9275-6fb2e22aa052",
"name": "BM DEVELOPERS LIMITED",
"status": "active",
"registrationNumber": "15463692",
"addressLine": "28 All Saints Croft, Burton-On-Trent, England, DE14 3EA",
"country": "GB"
}
]
}
Company Details — BM DEVELOPERS LIMITED
Request
Request
Copy
{
"transactionId": "9d53e4c6-53f3-45d6-8fe4-fdb6485fcJ5a8",
"companyId": "24689af7-f971-4ccd-9275-6fb2e22aa052",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": true
}
}
Response
Response
Copy
{
"status": true,
"data": [{
"company": {
"legalName": "BM DEVELOPERS LIMITED",
"tradingNames": [],
"status": "active",
"companyType": {},
"incorporationDate": "2024-02-03T00:00:00.000Z",
"registrationDate": null,
"country": "GB",
"registeredAddress": {
"singleLine": "28 All Saints Croft, DE14 3EA Burton-On-Trent, ENGLAND",
"structured": {
"line1": "28 All Saints Croft",
"line2": null,
"city": "Burton-On-Trent",
"postalCode": "DE14 3EA",
"region": null,
"country": "ENGLAND"
}
},
"businessAddress": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": "GB"
}
},
"identifiers": [
{
"scheme": "REGISTRATION_NUMBER",
"value": "15463692",
"country": null
}
],
"industryCodes": [],
"website": null,
"contacts": [],
"signatureRules": {
"signatureQuality": null
},
"resources": [],
"officers": [
{
"type": "director",
"officerId": "288",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "HUSSAIN, Abid",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "British",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
}
},
"status": null,
"from": "2025-01-15T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "director",
"officerId": "289",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "SULTAN, Nosha",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "British",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
}
},
"status": null,
"from": "2024-02-03T00:00:00.000Z",
"to": "2024-04-05T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
},
{
"type": "director",
"officerId": "290",
"officerData": {
"firstName": null,
"lastName": null,
"legalName": "SULTAN, Shoaib Ali",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": "British",
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "en",
"source": null
}
},
"status": null,
"from": "2024-05-05T00:00:00.000Z",
"to": "2025-01-15T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
}
],
"ownership": [
{
"ownerName": "Mr Abid Hussain",
"ownershipPercentage": "25-50",
"natureOfControl": "ownership-of-shares-25-to-50-percent",
"country": null
},
{
"ownerName": "Mr Shoaib Ali Sultan",
"ownershipPercentage": "25-50",
"natureOfControl": "ownership-of-shares-25-to-50-percent",
"country": null
},
{
"ownerName": "Mr Nosha Sultan",
"ownershipPercentage": "75",
"natureOfControl": "ownership-of-shares-75-to-100-percent, voting-rights-75-to-100-percent, right-to-appoint-and-remove-directors",
"country": null
}
],
"relationships": {
"ultimateBeneficialOwners": [],
"transparencyRegister": [],
"familyTree": [],
"isHeadquarter": null,
"isGlobalUltimate": null,
"isDomesticUltimate": null,
"isSubsidiary": null
}
}
}
]
}
AT
- Case AT-1 — IDCanopy Flexco
Search
Request
Request
Copy
{
"name": "IDCANOPY",
"country": "AT",
"locality": "Vienna"
}
Response
Response
Copy
{
"status": true,
"data": [
{
"transactionId": "02fbbcb4-2b21-49d7-87d7-0cfe0da63da5",
"companyId": "ef9ba1cb-ca7e-4a55-b133-4e633ae92661",
"name": "IDCANOPY FLEXCO",
"status": "Active",
"registrationNumber": "FN 628013Z",
"addressLine": "DR.-KARL-LUEGER-PLATZ 5",
"country": "AT"
}
]
}
Company Details — IDCANOPY FLEXCO
Request
Request
Copy
{
"transactionId": "02fbbcb4-2b21-49d7-87d7-0cfe0da63da5",
"companyId": "ef9ba1cb-ca7e-4a55-b133-4e633ae92661",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": true
}
}
Response
Response
Copy
{
"status": true,
"data":[{
"company": {
"status": "active",
"country": "AT",
"website": null,
"contacts": [],
"officers": [],
"ownership": [
{
"country": null,
"ownerName": "IDCANOPY GROUP LTD",
"natureOfControl": "unknown",
"ownershipPercentage": "100"
}
],
"resources": [],
"legalName": "IDCANOPY FLEXCO",
"identifiers": [
{
"value": "FN 628013Z",
"scheme": "REGISTRATION_NUMBER",
"country": "AT"
}
],
"companyType": {},
"relationships": {
"familyTree": [],
"isSubsidiary": null,
"isHeadquarter": null,
"isGlobalUltimate": null,
"isDomesticUltimate": null,
"transparencyRegister": [],
"ultimateBeneficialOwners": []
},
"tradingNames": [],
"industryCodes": [],
"signatureRules": {
"signatureQuality": null
},
"businessAddress": {
"structured": {
"city": null,
"line1": null,
"line2": null,
"region": null,
"country": "AT",
"postalCode": null
},
"singleLine": null
},
"registrationDate": null,
"incorporationDate": null,
"registeredAddress": {
"structured": {
"city": "WIEN",
"line1": "DR.-KARL-LUEGER-PLATZ 5",
"line2": null,
"region": "WIEN",
"country": "AT",
"postalCode": "1010"
},
"singleLine": "DR.-KARL-LUEGER-PLATZ 5, 1010 WIEN, AT"
}
}
}
]
}
IT
- Case IT-1 — WIND TELECOM
- Case IT-2 — LAVAZZA
Search
Request
Request
Copy
{
"name": "WIND",
"country": "IT",
"locality": "Rome"
}
Response
Response
Copy
{
"status": true,
"data": [
{
"transactionId": "968b703b-54cd-4a7c-8fc4-9300f14b9255",
"companyId": "c79bd0f4-b3ed-446b-8d47-e1a766feb307",
"name": "WIND TELECOM S.P.A.",
"status": "Active",
"registrationNumber": null,
"addressLine": "VIA CESARE GIULIO VIOLA, 48",
"country": "IT"
},
{
"transactionId": "968b703b-54cd-4a7c-8fc4-9300f14b9255",
"companyId": "196946f2-02c1-45c3-9f7f-d0529544ef57",
"name": "WIND NEGOZIO",
"status": "Active",
"registrationNumber": null,
"addressLine": "VIA DI BOCCEA 126",
"country": "IT"
},
{
"transactionId": "968b703b-54cd-4a7c-8fc4-9300f14b9255",
"companyId": "e7b6b29b-2f2c-438a-a62f-1485df17ff85",
"name": "WIND 3 SPA",
"status": "Active",
"registrationNumber": null,
"addressLine": "VIA CESARE GIULIO VIOLA 58",
"country": "IT"
},
{
"transactionId": "968b703b-54cd-4a7c-8fc4-9300f14b9255",
"companyId": "679ad594-bb39-49a7-992f-de2127740d7e",
"name": "WIND",
"status": "Active",
"registrationNumber": null,
"addressLine": "PIAZZA CARITÀ'3",
"country": "IT"
},
{
"transactionId": "968b703b-54cd-4a7c-8fc4-9300f14b9255",
"companyId": "1911d1bc-f597-49c7-befe-4221ea28215b",
"name": "WIND S.R.L.",
"status": "Active",
"registrationNumber": null,
"addressLine": "VIA LOMBARDIA 7/9",
"country": "IT"
},
{
"transactionId": "968b703b-54cd-4a7c-8fc4-9300f14b9255",
"companyId": "b387f4c8-6bfe-4318-97b0-aa142a518cc7",
"name": "WIND RETAIL S.R.L.",
"status": "Active",
"registrationNumber": null,
"addressLine": "VIA CESARE GIULIO VIOLA 48",
"country": "IT"
},
{
"transactionId": "968b703b-54cd-4a7c-8fc4-9300f14b9255",
"companyId": "6acdbf5b-5e75-4ff1-ac81-26dcc69fb1ed",
"name": "WIND S.R.L.",
"status": "Inactive",
"registrationNumber": "PR257550",
"addressLine": "VIA PARADIGNA 21/A",
"country": "IT"
}
]
}
Company Details — WIND TELECOM S.P.A.
Request
Request
Copy
{
"transactionId": "968b703b-54cd-4a7c-8fc4-9300f14b9255",
"companyId": "c79bd0f4-b3ed-446b-8d47-e1a766feb307",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": true
}
}
Response
Response
Copy
{
"status": true,
"data":[ {
"company": {
"legalName": "WIND TELECOM S.P.A.",
"tradingNames": [],
"status": "active",
"companyType": {},
"incorporationDate": null,
"registrationDate": null,
"country": "IT",
"registeredAddress": {
"singleLine": "VIA CESARE GIULIO VIOLA, 48, 00148 ROME, IT",
"structured": {
"line1": "VIA CESARE GIULIO VIOLA, 48",
"line2": null,
"city": "ROME",
"postalCode": "00148",
"region": "ROMA",
"country": "IT"
}
},
"businessAddress": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": "IT"
}
},
"identifiers": [],
"industryCodes": [],
"website": null,
"contacts": [],
"signatureRules": {
"signatureQuality": null
},
"resources": [],
"officers": [],
"ownership": [],
"relationships": {
"ultimateBeneficialOwners": [],
"transparencyRegister": [],
"familyTree": [],
"isHeadquarter": null,
"isGlobalUltimate": null,
"isDomesticUltimate": null,
"isSubsidiary": null
}
}
}
]
}
Search
Request
Request
Copy
{
"name": "Lavazza",
"country": "IT",
"locality": "Rome"
}
Response
Response
Copy
{
"status": true,
"data": [
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "89626945-fc2f-45e1-8968-4637711ca40c",
"name": "LAVAZZA",
"status": "Active",
"registrationNumber": null,
"addressLine": "VIA LEONARDO DA VINCI",
"country": "IT"
},
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "c4180eee-7490-4aa5-97ba-434f9eb7ad2b",
"name": "BAR LAVAZZA 140",
"status": "Active",
"registrationNumber": null,
"addressLine": "VIA ANASTASIO II 140",
"country": "IT"
},
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "b83818ab-a55a-4f6d-bd3f-57036d4a26c8",
"name": "LAVAZZA MARIO",
"status": "Active",
"registrationNumber": null,
"addressLine": "VIA GARIBALDI 35",
"country": "IT"
},
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "4dcf78b3-fd87-4080-8af2-badce3897041",
"name": "LAVAZZA LUIGI",
"status": "Active",
"registrationNumber": null,
"addressLine": "STRADA STATALE 121 KM 9.300",
"country": "IT"
},
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "3a99f55b-9fb8-458f-9415-727537e1ea00",
"name": "PAOLO LAVAZZA",
"status": "Active",
"registrationNumber": null,
"addressLine": "V. ROCCAVIONE 9",
"country": "IT"
},
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "5762b5d5-17f3-4a72-af48-e7cdc2827884",
"name": "LAVAZZA MARCO",
"status": "Active",
"registrationNumber": null,
"addressLine": "V. LUIGI GALVANI 27",
"country": "IT"
},
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "a742120d-8fbd-454f-b389-7f0bca801da6",
"name": "A. TEAM LAVAZZA S.R.L.",
"status": "Inactive",
"registrationNumber": null,
"addressLine": "VIA LIFIA 0",
"country": "IT"
},
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "8ce677d3-e117-4e85-9322-c58d88594f07",
"name": "A. TEAM LAVAZZA S.R.L.",
"status": "Inactive",
"registrationNumber": "ME219067",
"addressLine": "VIA LIFIA 0",
"country": "IT"
},
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "57c92298-f5aa-4b11-aaae-4fec8cf66390",
"name": "LAVAZZA LUCA",
"status": "Inactive",
"registrationNumber": "TO887902",
"addressLine": "PZA SOLFERINO 9",
"country": "IT"
}
]
}
Company Details — LAVAZZA
Request
Request
Copy
{
"transactionId": "542a50a7-97ab-4b2b-a4cf-fc47eb118463",
"companyId": "89626945-fc2f-45e1-8968-4637711ca40c",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": true
}
}
Response
Response
Copy
{
"status": true,
"data":[{
"company": {
"legalName": "LAVAZZA",
"tradingNames": [],
"status": "active",
"companyType": {},
"incorporationDate": null,
"registrationDate": null,
"country": "IT",
"registeredAddress": {
"singleLine": "VIA LEONARDO DA VINCI, 00054 FIUMICINO, IT",
"structured": {
"line1": "VIA LEONARDO DA VINCI",
"line2": null,
"city": "FIUMICINO",
"postalCode": "00054",
"region": null,
"country": "IT"
}
},
"businessAddress": {
"singleLine": "CORSO NOVARA 59, BOLZANO, IT",
"structured": {
"line1": "CORSO NOVARA 59",
"line2": null,
"city": "BOLZANO",
"postalCode": null,
"region": null,
"country": "IT"
}
},
"identifiers": [],
"industryCodes": [],
"website": null,
"contacts": [],
"signatureRules": {
"signatureQuality": null
},
"resources": [],
"officers": [],
"ownership": [],
"relationships": {
"ultimateBeneficialOwners": [],
"transparencyRegister": [],
"familyTree": [],
"isHeadquarter": null,
"isGlobalUltimate": null,
"isDomesticUltimate": null,
"isSubsidiary": null
}
}
}
]
}
DE
- Case DE-1 — Bosch GmbH
- Case DE-2 — Mueller.legal
- Case DE-3 — Porsche GmbH
Search
Request
Request
Copy
{
"name": "Bosch",
"country": "DE",
"locality": "Berlin"
}
Response
Response
Copy
{
"status": true,
"data": [
{
"transactionId": "134dbc33-10cd-41ad-a0d0-c5d6632de563",
"companyId": "9288e6fb-cedb-4945-b080-2a5d63cd0fe5",
"name": "Bosch GmbH",
"status": "active",
"registrationNumber": null,
"addressLine": "Pestalozziring, Aldenhoven",
"country": "DE"
},
]
}
Company Details — Bosch GmbH
Request
Request
Copy
{
"transactionId": "134dbc33-10cd-41ad-a0d0-c5d6632de563",
"companyId": "9288e6fb-cedb-4945-b080-2a5d63cd0fe5",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": true
}
}
Response
Response
Copy
{
"status": true,
"data":[ {
"company": {
"legalName": "Bosch GmbH",
"tradingNames": [],
"status": "active",
"companyType": {},
"incorporationDate": null,
"registrationDate": null,
"country": "DE",
"registeredAddress": {
"singleLine": "Pestalozziring, 52457 Aldenhoven, DE",
"structured": {
"line1": "Pestalozziring, Aldenhoven",
"line2": null,
"city": "Aldenhoven",
"postalCode": "52457",
"region": null,
"country": "DE"
}
},
"businessAddress": {
"singleLine": "Pestalozziring, Aldenhoven, DE",
"structured": {
"line1": "Pestalozziring, Aldenhoven",
"line2": null,
"city": "Aldenhoven",
"postalCode": null,
"region": null,
"country": "DE"
}
},
"identifiers": [
{
"scheme": "REGISTRATION_NUMBER",
"value": "HRB 4319",
"country": "DE"
}
],
"industryCodes": [],
"website": null,
"contacts": [],
"signatureRules": {
"signatureQuality": null
},
"resources": [],
"officers": [
{
"type": "director",
"officerId": "291",
"officerData": {
"firstName": "Rainer Norbert",
"lastName": "Bosch",
"legalName": "Rainer Norbert Bosch",
"dob": null,
"birthplace": null,
"countryOfBirth": null,
"nationality": null,
"country": null,
"identifiers": [],
"address": {
"singleLine": null,
"structured": {
"line1": null,
"line2": null,
"city": null,
"postalCode": null,
"region": null,
"country": null
}
},
"identityData": {}
},
"activity": {
"role": {
"native": {
"value": "director",
"language": "de",
"source": null
}
},
"status": null,
"from": null,
"to": null,
"phone": null,
"email": null,
"signatureRights": {
"signatureQuality": null
}
}
}
],
"ownership": [
{
"ownerName": "Bosch GmbH",
"ownershipPercentage": null,
"natureOfControl": "unknown",
"country": null
},
{
"ownerName": "Fertigbeton Rheinland GmbH & Co. KG",
"ownershipPercentage": null,
"natureOfControl": "unknown",
"country": null
}
],
"relationships": {
"ultimateBeneficialOwners": [],
"transparencyRegister": [],
"familyTree": [],
"isHeadquarter": null,
"isGlobalUltimate": null,
"isDomesticUltimate": null,
"isSubsidiary": null
}
}
}
]
}
Search
Request
Request
Copy
{
"name": "Müller",
"country": "DE",
"locality": "Berlin"
}
Response
Response
Copy
{
"status": true,
"data": [
{
"transactionId": "47b1e8a2-9d3c-4b1f-a5e7-6c2d8f1a0b94",
"companyId": "d9e3f1a0-bc6d-4721-8e5a-2f3b9c4d1e87",
"name": "Mueller.legal Müller Rechtsanwälte Partnerschaft PartG",
"status": "active",
"registrationNumber": "PR 930 B",
"addressLine": "Mauerstr. 66, 10117 Berlin, DE",
"country": "DE"
},
{
"transactionId": "47b1e8a2-9d3c-4b1f-a5e7-6c2d8f1a0b94",
"companyId": "a2c8e5f1-0b9d-4372-9a4f-7e1c3b5d6a80",
"name": "Gebr. Müller Müllerbräu GmbH & Co. KG",
"status": "active",
"registrationNumber": null,
"addressLine": null,
"country": "DE"
},
{
"transactionId": "47b1e8a2-9d3c-4b1f-a5e7-6c2d8f1a0b94",
"companyId": "6f1a9d3c-e8b2-4751-a0c7-2d4e8f3b1a95",
"name": "muellerfinancial GmbH",
"status": "active",
"registrationNumber": null,
"addressLine": null,
"country": "DE"
},
{
"transactionId": "47b1e8a2-9d3c-4b1f-a5e7-6c2d8f1a0b94",
"companyId": "bc7d1e8a-2f3c-4b9d-9e5a-1c0b8f4d2e73",
"name": "MüllerKälber GmbH",
"status": "active",
"registrationNumber": null,
"addressLine": null,
"country": "DE"
},
{
"transactionId": "47b1e8a2-9d3c-4b1f-a5e7-6c2d8f1a0b94",
"companyId": "3d9e1a0b-c7f2-4851-8a4d-9e2c1b3f0d57",
"name": "Muellerim UG",
"status": "active",
"registrationNumber": null,
"addressLine": null,
"country": "DE"
}
]
}
Company Details — Mueller.legal Müller Rechtsanwälte Partnerschaft PartG
Request
Request
Copy
{
"transactionId": "47b1e8a2-9d3c-4b1f-a5e7-6c2d8f1a0b94",
"companyId": "d9e3f1a0-bc6d-4721-8e5a-2f3b9c4d1e87",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": true
}
}
Response
Response
Copy
{
"status": true,
"data":[ {
"company": {
"legalName": "Mueller.legal Müller Rechtsanwälte Partnerschaft PartG",
"tradingNames": [],
"status": "active",
"companyType": {
"native": { "value": "PartG", "language": "de", "source": null }
},
"incorporationDate": null,
"registrationDate": "2014-06-03T00:00:00.000Z",
"country": "DE",
"registeredAddress": {
"singleLine": "Mauerstr. 66, 10117 Berlin, DE",
"structured": {
"line1": "Mauerstr. 66",
"line2": null,
"city": "Berlin",
"postalCode": "10117",
"region": null,
"country": "DE"
}
},
"businessAddress": {
"singleLine": null,
"structured": {
"line1": null, "line2": null, "city": null,
"postalCode": null, "region": null, "country": "DE"
}
},
"identifiers": [
{ "scheme": "REGISTRATION_NUMBER", "value": "PR 930 B", "country": "DE" },
{ "scheme": "VAT", "value": "DE281527011", "country": "DE" }
],
"industryCodes": [
{ "scheme": "WZ2008", "code": "69102", "label": null },
{ "scheme": "NACE", "code": "6910", "label": null }
],
"website": "https://sos-recht.de",
"contacts": [
{ "type": "phone", "value": "+49 30206436810" },
{ "type": "fax", "value": "+49 30206436811" },
{ "type": "email", "value": "info@mueller.legal" }
],
"signatureRules": {
"native": {
"value": "Jeder Partner vertritt die Gesellschaft allein.",
"language": "de",
"source": null
},
"signatureQuality": "individual"
},
"resources": [],
"officers": [
{
"type": "partner",
"officerId": "292",
"officerData": {
"firstName": "Carl-Christian",
"lastName": "Müller",
"legalName": "Carl-Christian Müller",
"dob": "1972-03-08",
"birthplace": "Berlin",
"countryOfBirth": "DE",
"nationality": null,
"country": "DE",
"identifiers": [],
"address": {
"singleLine": "Berlin, DE",
"structured": {
"line1": null, "line2": null, "city": "Berlin",
"postalCode": null, "region": null, "country": "DE"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "partner", "language": "de", "source": null }
},
"status": "active",
"from": "2014-06-03T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "individual" }
}
},
{
"type": "partner",
"officerId": "293",
"officerData": {
"firstName": "Sören Christian Günter",
"lastName": "Rößner",
"legalName": "Sören Christian Günter Rößner",
"dob": "1975-07-17",
"birthplace": "Oberwaldach",
"countryOfBirth": "DE",
"nationality": null,
"country": "DE",
"identifiers": [],
"address": {
"singleLine": "Oberwaldach, DE",
"structured": {
"line1": null, "line2": null, "city": "Oberwaldach",
"postalCode": null, "region": null, "country": "DE"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "partner", "language": "de", "source": null }
},
"status": "inactive",
"from": null,
"to": "2019-01-31T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "individual" }
}
},
{
"type": "partner",
"officerId": "294",
"officerData": {
"firstName": "Peter",
"lastName": "Weiler",
"legalName": "Peter Weiler",
"dob": "1984-11-19",
"birthplace": "Berlin",
"countryOfBirth": "DE",
"nationality": null,
"country": "DE",
"identifiers": [],
"address": {
"singleLine": "Berlin, DE",
"structured": {
"line1": null, "line2": null, "city": "Berlin",
"postalCode": null, "region": null, "country": "DE"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "partner", "language": "de", "source": null }
},
"status": "active",
"from": "2021-02-05T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "individual" }
}
},
{
"type": "partner",
"officerId": "295",
"officerData": {
"firstName": "Thomas Gerald",
"lastName": "Müller",
"legalName": "Thomas Gerald Müller",
"dob": "1977-10-05",
"birthplace": "Kleinmachnow",
"countryOfBirth": "DE",
"nationality": null,
"country": "DE",
"identifiers": [],
"address": {
"singleLine": "Kleinmachnow, DE",
"structured": {
"line1": null, "line2": null, "city": "Kleinmachnow",
"postalCode": null, "region": null, "country": "DE"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "partner", "language": "de", "source": null }
},
"status": "inactive",
"from": null,
"to": "2021-02-05T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "individual" }
}
}
],
"ownership": [],
"relationships": {
"ultimateBeneficialOwners": [],
"transparencyRegister": [],
"familyTree": [],
"isHeadquarter": null,
"isGlobalUltimate": null,
"isDomesticUltimate": null,
"isSubsidiary": null
}
}
}
]
}
Search
Request
Request
Copy
{
"name": "Porsche",
"country": "DE"
}
Response
Response
Copy
{
"status": true,
"data": [
{
"transactionId": "a8f2c3d1-e9b0-4742-b1a5-2d3e4f6a7b8c",
"companyId": "5e1d8a2c-3f9b-4c0d-a7e1-2b4f3d1c0a9e",
"name": "Porsche GmbH",
"status": "active",
"registrationNumber": "HRB 226427",
"addressLine": "Perlacher Str. 5 a, 82031 Grünwald, DE",
"country": "DE"
},
{
"transactionId": "a8f2c3d1-e9b0-4742-b1a5-2d3e4f6a7b8c",
"companyId": "c9b2a1d0-e8f3-4751-9a2c-4d5e6f7a8b1c",
"name": "Porsche Deutschland GmbH",
"status": "active",
"registrationNumber": null,
"addressLine": null,
"country": "DE"
},
{
"transactionId": "a8f2c3d1-e9b0-4742-b1a5-2d3e4f6a7b8c",
"companyId": "2d1e3f0a-b9c7-4851-a4d2-e1f0b3c2d5a7",
"name": "Porsche Consulting GmbH",
"status": "active",
"registrationNumber": null,
"addressLine": null,
"country": "DE"
},
{
"transactionId": "a8f2c3d1-e9b0-4742-b1a5-2d3e4f6a7b8c",
"companyId": "f8e3d1a2-c9b0-4742-9a5f-1e2c3d4b5a67",
"name": "Porsche Digital GmbH",
"status": "active",
"registrationNumber": null,
"addressLine": null,
"country": "DE"
},
{
"transactionId": "a8f2c3d1-e9b0-4742-b1a5-2d3e4f6a7b8c",
"companyId": "a0b1c2d3-e4f5-46a7-b8c9-d0e1f2a3b4c5",
"name": "Porsche Werkzeugbau GmbH",
"status": "active",
"registrationNumber": null,
"addressLine": null,
"country": "DE"
}
]
}
Company Details — Porsche GmbH
Request
Request
Copy
{
"transactionId": "a8f2c3d1-e9b0-4742-b1a5-2d3e4f6a7b8c",
"companyId": "5e1d8a2c-3f9b-4c0d-a7e1-2b4f3d1c0a9e",
"include": {
"officers": true,
"addresses": true,
"ownerships": true,
"transparency": true,
"documents": true,
"financials": true
}
}
Response
Response
Copy
{
"status": true,
"data":[{
"company": {
"legalName": "Porsche GmbH",
"tradingNames": [],
"status": "active",
"companyType": {
"native": { "value": "GmbH", "language": "de", "source": null }
},
"incorporationDate": null,
"registrationDate": "1958-03-13T00:00:00.000Z",
"country": "DE",
"registeredAddress": {
"singleLine": "Perlacher Str. 5 a, 82031 Grünwald, DE",
"structured": {
"line1": "Perlacher Str. 5 a",
"line2": null,
"city": "Grünwald",
"postalCode": "82031",
"region": null,
"country": "DE"
}
},
"businessAddress": {
"singleLine": null,
"structured": {
"line1": null, "line2": null, "city": null,
"postalCode": null, "region": null, "country": "DE"
}
},
"identifiers": [
{ "scheme": "REGISTRATION_NUMBER", "value": "HRB 226427", "country": "DE" }
],
"industryCodes": [
{ "scheme": "WZ2008", "code": "29320", "label": null },
{ "scheme": "NACE", "code": "2932", "label": null }
],
"website": null,
"contacts": [],
"signatureRules": {
"native": {
"value": "Ist nur ein Geschäftsführer bestellt, so vertritt er die Gesellschaft allein. Sind mehrere Geschäftsführer bestellt, so wird die Gesellschaft durch zwei Geschäftsführer oder durch einen Geschäftsführer gemeinsam mit einem Prokuristen vertreten.",
"language": "de",
"source": null
},
"signatureQuality": "joint"
},
"resources": [],
"officers": [
{
"type": "director",
"officerId": "296",
"officerData": {
"firstName": "Wolfgang",
"lastName": "Stoiber",
"legalName": "Wolfgang Stoiber",
"dob": "1959-05-14",
"birthplace": "Grünwald",
"countryOfBirth": "DE",
"nationality": null,
"country": "DE",
"identifiers": [],
"address": {
"singleLine": "Grünwald, DE",
"structured": {
"line1": null, "line2": null, "city": "Grünwald",
"postalCode": null, "region": null, "country": "DE"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "Geschäftsführer", "language": "de", "source": null },
"modeled": { "value": "Managing Director", "scheme": "idcanopy", "source": "modeled" }
},
"status": "active",
"from": "2024-07-18T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "joint" }
}
},
{
"type": "director",
"officerId": "297",
"officerData": {
"firstName": "Wolfgang Heinz",
"lastName": "Porsche",
"legalName": "Wolfgang Heinz Porsche",
"dob": "1943-05-10",
"birthplace": "Salzburg",
"countryOfBirth": "AT",
"nationality": null,
"country": "AT",
"identifiers": [],
"address": {
"singleLine": "Salzburg, AT",
"structured": {
"line1": null, "line2": null, "city": "Salzburg",
"postalCode": null, "region": null, "country": "AT"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "Geschäftsführer", "language": "de", "source": null },
"modeled": { "value": "Managing Director", "scheme": "idcanopy", "source": "modeled" }
},
"status": "active",
"from": "2014-05-07T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "joint" }
}
},
{
"type": "director",
"officerId": "298",
"officerData": {
"firstName": "Hans Michel",
"lastName": "Piëch",
"legalName": "Hans Michel Piëch",
"dob": "1942-01-10",
"birthplace": "Wien",
"countryOfBirth": "AT",
"nationality": null,
"country": "AT",
"identifiers": [],
"address": {
"singleLine": "Wien, AT",
"structured": {
"line1": null, "line2": null, "city": "Wien",
"postalCode": null, "region": null, "country": "AT"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "Geschäftsführer", "language": "de", "source": null },
"modeled": { "value": "Managing Director", "scheme": "idcanopy", "source": "modeled" }
},
"status": "active",
"from": "2014-05-07T00:00:00.000Z",
"to": null,
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "joint" }
}
},
{
"type": "director",
"officerId": "299",
"officerData": {
"firstName": "Eckhard F.",
"lastName": "Polzer",
"legalName": "Eckhard F. Polzer",
"dob": "1943-12-25",
"birthplace": "München",
"countryOfBirth": "DE",
"nationality": null,
"country": "DE",
"identifiers": [],
"address": {
"singleLine": "München, DE",
"structured": {
"line1": null, "line2": null, "city": "München",
"postalCode": null, "region": null, "country": "DE"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "Geschäftsführer", "language": "de", "source": null },
"modeled": { "value": "Managing Director", "scheme": "idcanopy", "source": "modeled" }
},
"status": "inactive",
"from": null,
"to": "2024-07-18T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "joint" }
}
},
{
"type": "director",
"officerId": "300",
"officerData": {
"firstName": "Michael",
"lastName": "Pressl",
"legalName": "Michael Pressl",
"dob": "1959-03-16",
"birthplace": "Salzburg",
"countryOfBirth": "DE",
"nationality": null,
"country": "DE",
"identifiers": [],
"address": {
"singleLine": "Salzburg, DE",
"structured": {
"line1": null, "line2": null, "city": "Salzburg",
"postalCode": null, "region": null, "country": "DE"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "Geschäftsführer", "language": "de", "source": null },
"modeled": { "value": "Managing Director", "scheme": "idcanopy", "source": "modeled" }
},
"status": "inactive",
"from": null,
"to": "2014-05-07T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "joint" }
}
},
{
"type": "director",
"officerId": "301",
"officerData": {
"firstName": "Karl-Heinz",
"lastName": "Moser",
"legalName": "Karl-Heinz Moser",
"dob": "1949-07-10",
"birthplace": "Wien",
"countryOfBirth": "AT",
"nationality": null,
"country": "AT",
"identifiers": [],
"address": {
"singleLine": "Wien, AT",
"structured": {
"line1": null, "line2": null, "city": "Wien",
"postalCode": null, "region": null, "country": "AT"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "Geschäftsführer", "language": "de", "source": null },
"modeled": { "value": "Managing Director", "scheme": "idcanopy", "source": "modeled" }
},
"status": "inactive",
"from": null,
"to": "2014-05-07T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "joint" }
}
},
{
"type": "director",
"officerId": "302",
"officerData": {
"firstName": "Hans Peter",
"lastName": "Schützinger",
"legalName": "Hans Peter Schützinger",
"dob": "1960-07-06",
"birthplace": "Salzburg",
"countryOfBirth": "AT",
"nationality": null,
"country": "AT",
"identifiers": [],
"address": {
"singleLine": "Salzburg, AT",
"structured": {
"line1": null, "line2": null, "city": "Salzburg",
"postalCode": null, "region": null, "country": "AT"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "Geschäftsführer", "language": "de", "source": null },
"modeled": { "value": "Managing Director", "scheme": "idcanopy", "source": "modeled" }
},
"status": "inactive",
"from": null,
"to": "2011-04-14T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "joint" }
}
},
{
"type": "director",
"officerId": "303",
"officerData": {
"firstName": "Wolf-Dieter",
"lastName": "Hellmaier",
"legalName": "Wolf-Dieter Hellmaier",
"dob": "1943-09-14",
"birthplace": "Salzburg",
"countryOfBirth": "AT",
"nationality": null,
"country": "AT",
"identifiers": [],
"address": {
"singleLine": "Salzburg, AT",
"structured": {
"line1": null, "line2": null, "city": "Salzburg",
"postalCode": null, "region": null, "country": "AT"
}
},
"identityData": {}
},
"activity": {
"role": {
"native": { "value": "Geschäftsführer", "language": "de", "source": null },
"modeled": { "value": "Managing Director", "scheme": "idcanopy", "source": "modeled" }
},
"status": "inactive",
"from": null,
"to": "2011-04-14T00:00:00.000Z",
"phone": null,
"email": null,
"signatureRights": { "signatureQuality": "joint" }
}
}
],
"ownership": [],
"relationships": {
"ultimateBeneficialOwners": [],
"transparencyRegister": [],
"familyTree": [],
"isHeadquarter": null,
"isGlobalUltimate": null,
"isDomesticUltimate": null,
"isSubsidiary": null
}
}
}
]
}
Error Cases
- Error 1 — Missing Country
- Error 2 — Wrong Endpoint
Calling
/kyb/search without the required country field returns a 400 Bad Request.Request
Request
Copy
{
"name": "Bosch",
"locality": "Berlin"
}
Response
Response
Copy
400 Bad Request
Copy
{
"status": false,
"error": "Validation failed: country: Required"
}
Calling an incorrect path returns
404 Not Found.Request
Request
Copy
endpoint /kyb/company/search
Response
Response
Copy
This page could not be found.