Overview

Use this method to get the company check results after the company applicant has been reviewed.

Request example

curl -X GET \
  'https://api.sumsub.com/resources/checks/latest?type=COMPANY&applicantId=6eea3f5204f940217bcbc05d'

Response explained

The response represents a list of checks with the company information. All attributes below are nullable.

Root variables
- companyCheckInfo
  - industryCodes
  - licenseInfo
  - officers and significantPersons
Example response

Root variables

The following table explains the root variables of the response.

Name	Type	Description
`answer`	String	Company check answer (`GREEN`/`RED`/`YELLOW`).
`createdAt`	Date	Time and date of the latest company check result.
`companyCheckInfo`	Object	Company check data.

`companyCheckInfo` attributes

The following table explains the companyCheckInfo attributes representing the company data checked.

Name	Type	Description
`companyName`	String	Company name.
`companyNumber`	String	Company registry number.
`status`	String	Company status.
`type`	String	Company type.
`source`	String	Company data source/registry.
`sourceUrl`	String	Source URL.
`webPage`	String	Company web page address.
`phone`	String	Company phone number.
`email`	String	Company email address.
`officeAddress`	String	Company office address.
`incorporatedOn`	Date	Date of incorporation.
`industryCodes`	Array of objects	List of industry codes and descriptions.
`alternativeNames`	List of Strings	List of alternative company names.
`licenseInfo`	Object	Company license info.
`officers`	Array of objects	List of company officers.
`significantPersons`	Array of objects	List of significant company persons.
`affiliatedCompanies`	Array of objects	List of affiliated companies (has the same attributes as `companyCheckInfo`).

`industryCodes` attributes

Name	Type	Description
`code`	String	Company industry code.
`description`	String	Industry description.

`licenseInfo` attributes

Name	Type	Description
`licenseNumber`	String	License number.
`issuedDate`	Date	Date of issue.
`validUntil`	Date	Date of expiry.

`officers` and `significantPersons` attributes

Name	Type	Description
`fullName`	String	Full name.
`type`	String	Indicates if the officer or significant person is an individual or a legal entity (`Individual` or `Business`).
`directOwnershipPercent`	Double	Direct percentage of the value of the outstanding stock of the corporation that the stockholder owns.
`indirectOwnershipPercent`	Double	Indirect percentage of the value of the outstanding stock of the corporation that the stockholder owns.
`beneficialOwnershipPercent`	Double	Beneficial percentage of the ownership and control of the company the person has.
`dob`	Date	Date of birth.
`nationality`	String	Nationality.
`country`	String	Country of residence.
`degreeOfSeparation`	Integer	Level of beneficial owner in the control hierarchy: `0` — When the company itself is described in the structure, so there is no separation. `1` — Beneficial owner directly holds an interest in the company. `2` — Beneficial owner holds an interest through one intermediate company. `3` — Beneficial owner holds an interest through two intermediate companies, and so on upwards.
`idNumber`	String	Identifier of the primary document of the officer or owner.
`occupation`	String	Occupation.
`appointedOn`	Date	Date of person being appointed.
`correspondenceAddress`	String	Correspondence address.
`correspondenceAddressStructured`	Object	Structured information related to the correspondence address of the company.
`natureOfControl`	String	Nature of control.
`role`	String	Role.
`status`	String	Status.

`correspondenceAddressStructured` attributes

Field	Type	Description
`postCode`	String	Postal code.
`country`	String	Alpha-3 country code (for example, `DEU`, `GBR`, `ARG`, and so on).
`formattedAddress`	String	Address in the human readable format. For example, `Design Offices, Philipsbornstraße 2, 30165 Hannover, Germany`.

Response example

{
  "checks": [
    {
      "answer": "GREEN",
      "createdAt": "2022-04-05 17:12:31",
      "companyCheckInfo": {
        "companyName": "your_company_name",
        "companyNumber": "00012389",
        "status": "active",
        "type": "ltd",
        "webPage" : "www.your_company_name.com",
        "phone" : "+440000000000",
        "email" : "[email protected]",
        "source": "UK Government Digital Service",
        "sourceUrl": "https://find-and-update.company-information.service.gov.uk/?_ga=2.187069601.885610489.1610661798-159972951.1610661798",
        "industryCodes": [
          {
            "code": "74909",
            "description": "Other professional, scientific and technical activities n.e.c."
          }
        ],
        "incorporatedOn": "2015-07-16 00:00:00",
        "officeAddress": "Office Address London England",
        "officers": [
          {
            "fullName": "Doe Simon John",
            "type": "Individual",
            "beneficialOwnershipPercent" : 4.6,
            "dob": "1986-06-01 00:00:00",
            "nationality": "Israeli",
            "country": "Cyprus",
            "degreeOfSeparation" : 2,
            "occupation": "Manager",
            "appointedOn": "2015-07-16 00:00:00",
            "correspondenceAddress": "Correspondence Address London England",
            "correspondenceAddressStructured" : {
              "postCode" : "0000",
              "country" : "CYP",
              "formattedAddress" : "Some Address, London England"
            },
            "role": "director",
            "status": "active"
          }
        ],
        "significantPersons": [
          {
            "fullName": "Some Trade Ltd",
            "type" : "Business",
            "directOwnershipPercent" : 75.0,
            "degreeOfSeparation" : 1,
            "notifiedOn": "2019-04-18 00:00:00",
            "correspondenceAddress": "Correspondence Address London England",
            "correspondenceAddressStructured" : {
              "postCode" : "0000",
              "country" : "GBR",
              "formattedAddress" : "Some Address, London England"
            },
            "natureOfControl": "[ \"ownership-of-shares-75-to-100-percent\" , \"voting-rights-75-to-100-percent\" , \"right-to-appoint-and-remove-directors\"]",
            "status": "active"
          },
          {
            "fullName": "Mr John Doe",
            "type" : "Individual",
            "indirectOwnershipPercent" : 25.00,
            "degreeOfSeparation" : 2,
            "dob": "1986-06-01 00:00:00",
            "nationality": "Israeli",
            "country": "Israel",
            "notifiedOn": "2016-04-06 00:00:00",
            "correspondenceAddress": "Some St. 3570000 Haifa Israel",
            "correspondenceAddressStructured" : {
              "postCode" : "0000",
              "country" : "ISR",
              "formattedAddress" : "Some St. 3570000 Haifa Israel"
            },
            "natureOfControl": "[ \"ownership-of-shares-75-to-100-percent\"]",
            "status": "resigned"
          }
        ]
      }
    }
  ]
}

Overview

Request example

Response explained

Root variables

companyCheckInfo attributes

industryCodes attributes

licenseInfo attributes