> ## Documentation Index
> Fetch the complete documentation index at: https://umbrella-docs.info/llms.txt
> Use this file to discover all available pages before exploring further.
# KYB API
> Know Your Business — company search and data enrichment
# 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`)](#authentication)** — Obtain a Bearer token using your `Api-Key` and `Customer-Id`. Required before any other call.
* **[Search (`/kyb/search`)](#1-search-company)** — Find a company by name or registration number. Returns a `companyId` and `transactionId` required for the next step.
* **[Company Details (`/kyb/company/details`)](#2-company-details)** — Retrieve the full company record. The `include` parameter controls which data packages are returned; each package is priced separately. Document and transparency packages return a list of available items with `linkToken` values.
* **[Document Retrieval (`/kyb/company/document/retrieve`)](#3-document-retrieval)** — Fetch an individual document or transparency register entry using a `linkToken` from the details response.
Where available, structured fields are returned in two forms: **native** (verbatim from the register, in the original language) and **modeled** (normalised to a common English scheme via `idcanopy`). All other data is passed through as-is from the source.
Try the search endpoint [here](/api-reference/endpoint/kyb_search).
Try the company details endpoint [here](/api-reference/endpoint/kyb_company_details).
***
## 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
```bash theme={null}
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
```json theme={null}
{
"access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"expires_in": 3600,
"token_type": "Bearer"
}
```
Use the `access_token` value in the `Authorization` header of all subsequent requests:
```
Authorization: Bearer
```
### 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 ` |
### 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
```json theme={null}
{
"name": "IDCanopy Group Ltd",
"country": "GB",
"locality": "London"
}
```
### Example Request — by registration number
```json theme={null}
{
"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
```json theme={null}
{
"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 ` |
### 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
```json theme={null}
{
"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
| 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. |
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`). |
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`). |
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
```json theme={null}
{
"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 ` |
### 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
```json theme={null}
{
"transactionId": "a8b89ef3-9d93-4d96-a495-be605fd1b2fe",
"companyId": "223c8dde-9c82-4811-ba3c-4f9fe648c2da",
"linkToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
}
```
### Response
Returns the document as a binary file stream. The `Content-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
#### Search
```json theme={null}
{
"name": "Waitrose",
"country": "GB",
"locality": "London"
}
```
```json theme={null}
{
"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
```json theme={null}
{
"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
}
}
```
```json theme={null}
{
"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. Same `transactionId`, different `companyId`.
```json theme={null}
{
"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
}
}
```
```json theme={null}
{
"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
```json theme={null}
{
"name": "BM Dev",
"country": "GB",
"companyNo": "15463692",
"locality": "London"
}
```
```json theme={null}
{
"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
```json theme={null}
{
"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
}
}
```
```json theme={null}
{
"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
#### Search
```json theme={null}
{
"name": "IDCANOPY",
"country": "AT",
"locality": "Vienna"
}
```
```json theme={null}
{
"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
```json theme={null}
{
"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
}
}
```
```json theme={null}
{
"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
#### Search
```json theme={null}
{
"name": "WIND",
"country": "IT",
"locality": "Rome"
}
```
```json theme={null}
{
"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.
```json theme={null}
{
"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
}
}
```
```json theme={null}
{
"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
```json theme={null}
{
"name": "Lavazza",
"country": "IT",
"locality": "Rome"
}
```
```json theme={null}
{
"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
```json theme={null}
{
"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
}
}
```
```json theme={null}
{
"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
#### Search
```json theme={null}
{
"name": "Bosch",
"country": "DE",
"locality": "Berlin"
}
```
```json theme={null}
{
"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
```json theme={null}
{
"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
}
}
```
```json theme={null}
{
"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
```json theme={null}
{
"name": "Müller",
"country": "DE",
"locality": "Berlin"
}
```
```json theme={null}
{
"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
```json theme={null}
{
"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
}
}
```
```json theme={null}
{
"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
```json theme={null}
{
"name": "Porsche",
"country": "DE"
}
```
```json theme={null}
{
"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
```json theme={null}
{
"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
}
}
```
```json theme={null}
{
"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
Calling `/kyb/search` without the required `country` field returns a `400 Bad Request`.
```json theme={null}
{
"name": "Bosch",
"locality": "Berlin"
}
```
```
400 Bad Request
```
```json theme={null}
{
"status": false,
"error": "Validation failed: country: Required"
}
```
Calling an incorrect path returns `404 Not Found`.
```
endpoint /kyb/company/search
```
```
This page could not be found.
```