W2 DocsBusiness Search
About service
This service allows for a global business lookup.
How to use
To call the endpoint you will need to perform a HTTP POST request to the URL:
| Url | API Version |
|---|---|
| https://api.w2globaldata.com/business/search | 2.1+ |
Request
The following properties pertain to searching a business.
| Property Name | Type | Optional/Mandatory | Notes |
|---|---|---|---|
| CountryCode | String | Mandatory | The Country of the business. We require this to be a standard 3 letter ISO code to ensure compatibility with all our services. |
| Name | String | Optional* | |
| RegistrationNumber | String | Optional* | |
| LookupId | String | Optional* |
Notes
At least one of Name or RegistrationNumber is required for searching for a UK business. For non-UK businesses at least one of Name, RegistrationNumber or the LookupId is required.
Example Request
json
{
"Name": "Adidas",
"CountryCode": "DEU"
}Example Response
json
{
"totalCount": 2,
"businesses": [
{
"name": "adidas Originals",
"countryCode": "DEU",
"kybLookupId": "DE-1-DEXXXXXX",
"type": "NonLtd",
"status": "Active",
"dateOfLatestAccountsSpecified": false,
"address": [
"Address 11, 39104, Magdeburg"
]
},
{
"name": "adidas AG",
"countryCode": "DEU",
"kybLookupId": "DE-0-DEXXXXXX",
"type": "Ltd",
"status": "Active",
"registrationNumber": "HRB XXXX",
"dateOfLatestAccountsSpecified": true,
"dateOfLatestAccounts": "2021-12-31T00:00:00Z",
"address": [
"Address 1, 91074, Herzogenaurach"
],
"vatNo": [
"DE1XXXXXXX"
]
}
]
}Response Breakdown
| Property | Description |
|---|---|
| TotalCount | The number of businesses returned from the search. |
| Businesses | An array of Business objects. |
Business Object
| Property | Description |
|---|---|
| Name | String or null. The name of the business returned. |
| CountryCode | String or null. The 3-letter ISO country code for the business. |
| LookupId | String or null. KYB specific id returned for a business. |
| Type | String or null. Can be one of the following: NotSet, Ltd, NonLtd, NonLtdNonReg |
| IncorporationDate | DateTime string or null. Date of incorporation. |
| OfficialStatus | String or null. |
| SimplifiedStatus | String or null. |
| Status | String or null. |
| RegistrationNumber | String or null. The registration number of the business. Such as a Companies House company number. |
| DateOfLatestAccountsSpecified | Bool or null. |
| Domains | Array of strings or null. An array of domains associated with the business. |
| DateOfLatestAccounts | DateTime string or null. |
| Address | Array of strings or null. An array of full single line addresses associated with the business. |
| VatNo | String or null. Vat Number associated with the business. |