GRgriffin
Companies House

Lookup company

Changed on

Lookup Companies House company by company number. Includes information about the company, its directors, and persons with significant control.

get/v0/companies-house/companies/{company-number}

Request

  • Base URL
    https://api.griffin.com
  • Auth
    API key in header Authorization

Path parameters

company-numberstring required

UK Companies House company number

Response

OK

date-of-latest-accountsstring date

ISO 8601 formatted date.

entity-namestring required
date-of-latest-confirmation-statementstring date

ISO 8601 formatted date.

corporation-type'private-limited-guarant-nsc-limited-exemption' | 'eeig' | 'private-limited-shares-section-30-exemption' | 'limited-partnership' | 'royal-charter' | 'private-unlimited-nsc' | 'old-public-company' | 'investment-company-with-variable-capital' | 'other-company-type' | 'converted-or-closed' | 'protected-cell-company' | 'private-limited-guarant-nsc' | 'scottish-charitable-incorporated-organisation' | 'industrial-and-provident-society' | 'registered-society-non-jurisdictional' | 'private-unlimited' | 'further-education-or-sixth-form-college-corporation' | 'limited-liability-partnership' | 'assurance-company' | 'other' | 'northern-ireland-other' | 'charitable-incorporated-organisation' | 'oversea-company' | 'icvc-securities' | 'uk-establishment' | 'unregistered-company' | 'icvc-warrant' | 'registered-overseas-entity' | 'public-limited-company' | 'private-limited-company' | 'european-public-limited-liability-company-se' | 'private-unlimted-nsc' | 'northern-ireland' | 'icvc-umbrella' | 'scottish-partnership' required
company-status'dissolved' | 'active' | 'receivership' | 'registered' | 'removed' | 'administration' | 'open' | 'closed' | 'voluntary-arrangement' | 'liquidation' | 'converted-closed' | 'insolvency-proceedings' required
accounts-overdueboolean
sic-codesstring[]
confirmation-statement-overdueboolean
date-of-incorporationstring date required

ISO 8601 formatted date.

entity-registration-numberstring required

The entity number assigned by the local register. For UK companies that's the Companies House company number.

Example response

{
  "company-address": {
    "postal-code": "NW16XE",
    "country-code": "GB"
  },
  "directors": [
    {
      "companies-house-url": "https://api.company-information.service.gov.uk/company/00000001/appointments/AbcDEFGhI1JKLmnO2PQ3sTUv4WX"
    }
  ],
  "sic-codes": [
    "12345"
  ],
  "persons-with-significant-control": [
    {
      "companies-house-url": "https://api.company-information.service.gov.uk/company/00000001/appointments/AbcDEFGhI1JKLmnO2PQ3sTUv4WX"
    }
  ]
}

Changes