Companies

Get company by number

Retrieve detailed company profile by Companies House number. A company that closed before the register we hold is answered from its archived final register entry or, failing that, from Companies House: data_source is then dissolved_archive or companies_house_live, with company_status and dissolution_date.

get/company/{number}

Request

  • Base URL: https://api.companystack.co.uk
  • URL: https://api.companystack.co.uk/company/{number}
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Path parameters

numberstring required

Response

Company profile

company_numberstring required

8 characters, e.g. 00445790 or SC586124

company_namestring required
company_statusstring required

e.g. active, dissolved, liquidation

company_typestring
date_of_creationstring date
dissolution_datestring date
registered_office_addressstring

The registered office as one comma-separated line

country_of_originstring
data_sourcestring
entity_kind'company' | 'llp' | 'lp' | 'scottish_partnership' | 'overseas' | 'other'

GET /company/{number} only. The kind of entity, decided from company_type and, only when that is missing or "Other company type", from the number prefix: company; llp (limited liability partnership); lp (limited partnership); scottish_partnership; overseas (overseas companies, UK establishments and overseas entities); other (for example charitable incorporated organisations, registered societies, royal charter bodies, ICVCs and economic interest groupings).

Example response

{
  "registrar_default_address": {
    "statement": "Registered office removed by Companies House: the company is at the registrar's default address"
  },
  "entity_kind": "llp",
  "people_term": {
    "one": "member",
    "many": "members"
  },
  "limited_partnership": {
    "general_partners": 1,
    "limited_partners": 14
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.