API Status

Company check

Match given inputs against registered companies in the UK and Ireland. A billable company report will be generated using the following rules:

Reasons for a FAIL result

  • Simplified company status is Closed
  • A current officer is disqualified
  • No company was matched
  • Company matched has no data
  • PEPs and sanctions check returned one or more businesses with a match score of 100

Possible warnings (Will not cause a FAIL)

  • Simplified company status is Intermediate
  • One or more Gazette notices were found
  • No shareholder information was found
  • No shareholder information was found for the ultimate parent
  • Ultimate parent is a foreign company
  • Annual return or confirmation statement is overdue
  • Accounts are overdue
  • A former officer is disqualified
  • PEPs and sanctions check returned one or more businesses with a match score at or above 80

If multiple potential matches are found, a pick list is returned with enough information to allow for a more specific subsequent request (not billable).

Sandbox

In Sandbox environment this endpoint will generate static response from historical data of real company check reports for 7 predefined company searches. All other requests will result in report not found response (HTTP 404).

Example search requests

  • Hsbc Holdings Plc
    {
      "companyId": "00617987"
    } 
    

  • Woolworths Group Plc
    {
      "companyId": "03855289"
    } 
    

  • Royal Dutch Shell Plc
    {
      "companyId": "04366849"
    } 
    

  • Evi Technologies Limited
    {
      "companyId": "04660006"
    } 
    

  • Duedil Limited
    {
      "companyId": "06999618"
    } 
    

  • Brompton Bicycle Limited
    {
      "companyId": "01261512",
      "name": "Brompton Bicycle Limited",
      "countryCodes": {
          "values": [
              "GB"
          ]
      }
    } 
    

  • Tesco name search
    {
      "name": "tesco",
      "countryCodes": {
          "values": [
              "GB"
          ]
      }
    } 
    

Language
Authorization
Header
URL
Click Try It! to start a request and see the response here!