Search company

Searches for a company by name and incorporation country and returns a list of matching companies and summary details.

To retrieve all available data for a given company, use the get company details endpoint.

URL

POST https://api.complycube.com/v1/lookup/companies

Headers

Name	Type	Description
Authorization*	string	The API live or test key.
Content-Type*	string	The content-type must always be set to application/json.

Body

Name	Type	Description
companyName*	string	The incorporation name of the company.
incorporationCountry*	string	The company's incorporation country. This will be the two-letter country ISO code.

Example request

cURL

curl -X POST https://api.complycube.com/v1/lookup/companies \
     -H 'Authorization: <YOUR_API_KEY>' \
     -H 'Content-Type: application/json' \
     -d '{
               "companyName": "Stripe Payments Europe Limited",
	       "incorporationCountry": "IE"
        }'

Node.js

const { ComplyCube } = require("@complycube/api");

const complycube = new ComplyCube({ apiKey: "<YOUR_API_KEY>" });

const client = await complycube.lookup.searchCompany({
  companyName: "Stripe Payments Europe Limited",
  incorporationCountry: "IE"
});

The Company summary object

Attribute	Type	Description
id	string	The unique identifier for a company.
name	string	The registered name of the company.
registrationNumber	string	The registration number of the company.
incorporationCountry	string	The incorporation country of the company.
incorporationDate	string	The date the company was incorporated. The format is YYYY-MM-DD.
incorporationType	string	The incorporation type of the company.
address	object	The structured address of the company.
active	boolean	Indicates if a company is active.
sourceUrl	string	The source URL from which the data was obtained.
createdAt	string	The date and time when the company record was created at source.
updatedAt	string	The date and time when the company record was updated at source.

Example response

Success (200)

 {
     "totalItems": 1,
     "items": [
        {
            "id": "69655f5f353133313734",
            "name": "STRIPE PAYMENTS EUROPE, LIMITED",
            "registrationNumber": "513174",
            "incorporationCountry": "IE",
            "incorporationDate": "2012-05-15",
            "incorporationType": "LTD - Private Company Limited by Shares",
            "sourceUrl": "http://www.cro.ie/search/CompanyDetails.aspx?id=513174&type=C",
            "active": true,
            "createdAt": "2012-06-03T05:18:48+00:00",
            "updatedAt": "2021-10-22T17:38:46+00:00",
            "address": {
                "line": "C/O A&L GOODBODY, IFSC, NORTH WALL QUAY, DUBLIN 1.",
                "country": "IE",
                "fullAddress": "C/O A&L GOODBODY, IFSC, NORTH WALL QUAY, DUBLIN 1."
            }
        }
    ]
}