Business Search

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	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

{
    "Name": "Adidas",
    "CountryCode": "DEU"
}

Response

Example Response

{
    "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.

Docs not making sense? Please contact us so we can fix them: [email protected] :)