BETA This is a new service.

Methods

  • get - Get the basic company information

Resource Representation

{
   "accounts" : {
      "accounting_reference_date" : {
         "day" : "integer",
         "month" : "integer"
      },
      "last_accounts" : {
         "made_up_to" : "date",
         "period_end_on" : "date",
         "period_start_on" : "date",
         "type" : "string"
      },
      "next_accounts" : {
         "due_on" : "date",
         "overdue" : "boolean",
         "period_end_on" : "date",
         "period_start_on" : "date"
      },
      "next_due" : "date",
      "next_made_up_to" : "date",
      "overdue" : "boolean"
   },
   "annual_return" : {
      "last_made_up_to" : "date",
      "next_due" : "date",
      "next_made_up_to" : "date",
      "overdue" : "boolean"
   },
   "branch_company_details" : {
      "business_activity" : "string",
      "parent_company_name" : "string",
      "parent_company_number" : "string"
   },
   "can_file" : "boolean",
   "company_name" : "string",
   "company_number" : "string",
   "company_status" : "string",
   "company_status_detail" : "string",
   "confirmation_statement" : {
      "last_made_up_to" : "date",
      "next_due" : "date",
      "next_made_up_to" : "date",
      "overdue" : "boolean"
   },
   "date_of_cessation" : "date",
   "date_of_creation" : "date",
   "etag" : "string",
   "foreign_company_details" : {
      "accounting_requirement" : {
         "foreign_account_type" : "string",
         "terms_of_account_publication" : "string"
      },
      "accounts" : {
         "account_period_from" : {
            "day" : "integer",
            "month" : "integer"
         },
         "account_period_to" : {
            "day" : "integer",
            "month" : "integer"
         },
         "must_file_within" : {
            "months" : "integer"
         }
      },
      "business_activity" : "string",
      "company_type" : "string",
      "governed_by" : "string",
      "is_a_credit_finance_institution" : "boolean",
      "originating_registry" : {
         "country" : "string",
         "name" : "string"
      },
      "registration_number" : "string"
   },
   "has_been_liquidated" : "boolean",
   "has_charges" : "boolean",
   "has_insolvency_history" : "boolean",
   "is_community_interest_company" : "boolean",
   "jurisdiction" : "string",
   "last_full_members_list_date" : "date",
   "links" : {
      "charges" : "string",
      "filing_history" : "string",
      "insolvency" : "string",
      "officers" : "string",
      "persons_with_significant_control" : "string",
      "persons_with_significant_control_statements" : "string",
      "registers" : "string",
      "self" : "string"
   },
   "partial_data_available" : "string",
   "previous_company_names" : [
      {
         "ceased_on" : "date",
         "effective_from" : "date",
         "name" : "string"
      }
   ],
   "registered_office_address" : {
      "address_line_1" : "string",
      "address_line_2" : "string",
      "care_of" : "string",
      "country" : "string",
      "locality" : "string",
      "po_box" : "string",
      "postal_code" : "string",
      "premises" : "string",
      "region" : "string"
   },
   "registered_office_is_in_dispute" : "boolean",
   "sic_codes" : [
      "string"
   ],
   "type" : "string",
   "undeliverable_registered_office_address" : "boolean"
}
Parameter NameTypeDescriptionAdditional
accounts object Company accounts information. Optional.
accounts.accounting_reference_date object The Accounting Reference Date (ARD) of the company. Optional.
accounts.accounting_reference_date.day integer The Accounting Reference Date (ARD) day.
accounts.accounting_reference_date.month integer The Accounting Reference Date (ARD) month.
accounts.last_accounts object The last company accounts filed. Optional.
accounts.last_accounts.made_up_to date To be deprecated. Please use period_end_on.
accounts.last_accounts.period_end_on date The last day of the most recently filed accounting period Optional.
accounts.last_accounts.period_start_on date The first day of the most recently filed accounting period Optional.
accounts.last_accounts.type string The type of the last company accounts filed.

For enumeration descriptions see account_type section in the enumeration mappings.

Possible values are:
  • null
  • full
  • small
  • medium
  • group
  • dormant
  • interim
  • initial
  • total-exemption-full
  • total-exemption-small
  • partial-exemption
  • audit-exemption-subsidiary
  • filing-exemption-subsidiary
  • micro-entity
accounts.next_accounts object The next company accounts filed. Optional.
accounts.next_accounts.due_on date The date the next company accounts are due. Optional.
accounts.next_accounts.overdue boolean Flag indicating if the company accounts are overdue. Optional.
accounts.next_accounts.period_end_on date The last day of the next accounting period to be filed. Optional.
accounts.next_accounts.period_start_on date The first day of the next accounting period to be filed. Optional.
accounts.next_due date To be deprecated. Please use next_accounts.due_on. Optional.
accounts.next_made_up_to date To be deprecated. Please use next_accounts.period_end_on.
accounts.overdue boolean To be deprecated. Please use next_accounts.overdue
annual_return object Annual return information. This member is only returned if a confirmation statement has not be filed. Optional.
annual_return.last_made_up_to date The date the last annual return was made up to. Optional.
annual_return.next_due date The date the next annual return is due. This member will only be returned if a confirmation statement has not been filed and the date is before 28th July 2016, otherwise refer to confirmation_statement.next_due Optional.
annual_return.next_made_up_to date The date the next annual return should be made up to. This member will only be returned if a confirmation statement has not been filed and the date is before 30th July 2016, otherwise refer to confirmation_statement.next_made_up_to Optional.
annual_return.overdue boolean Flag indicating if the annual return is overdue. Optional.
branch_company_details object UK branch of a foreign company. Optional.
branch_company_details.business_activity string Type of business undertaken by the UK establishment. Optional.
branch_company_details.parent_company_name string Parent company name.
branch_company_details.parent_company_number string Parent company number.
can_file boolean Flag indicating whether this company can file.
company_name string The name of the company.
company_number string The number of the company.
company_status string The status of the company.

For enumeration descriptions see company_status section in the enumeration mappings.
Possible values are:
  • active
  • dissolved
  • liquidation
  • receivership
  • administration
  • voluntary-arrangement
  • converted-closed
  • insolvency-proceedings
Optional.
company_status_detail string Extra details about the status of the company.

For enumeration descriptions see company_status_detail section in the enumeration mappings.
Possible values are:
  • transferred-from-uk
  • active-proposal-to-strike-off
  • petition-to-restore-dissolved
  • transformed-to-se
  • converted-to-plc
Optional.
confirmation_statement object Confirmation statement information. Optional.
confirmation_statement.last_made_up_to date The date to which the company last made a confirmation statement. Optional.
confirmation_statement.next_due date The date by which the next confimation statement must be received.
confirmation_statement.next_made_up_to date The date to which the company must next make a confirmation statement.
confirmation_statement.overdue boolean Flag indicating if the confirmation statement is overdue. Optional.
date_of_cessation date The date which the company was converted/closed or dissolved. Please refer to company status to determine which. Optional.
date_of_creation date The date when the company was created. Optional.
etag string The ETag of the resource. Optional. Read only
foreign_company_details object Foreign company details. Optional.
foreign_company_details.accounting_requirement object Accounts requirement. Optional.
foreign_company_details.accounting_requirement.foreign_account_type string Type of accounting requirement that applies.

For enumeration descriptions see foreign_account_type section in the enumeration mappings.
Possible values are:
  • accounting-requirements-of-originating-country-apply
  • accounting-requirements-of-originating-country-do-not-apply
Optional.
foreign_company_details.accounting_requirement.terms_of_account_publication string Describes how the publication date is derived.

For enumeration descriptions see terms_of_account_publication section in the enumeration mappings.
Possible values are:
  • accounts-publication-date-supplied-by-company
  • accounting-publication-date-does-not-need-to-be-supplied-by-company
  • accounting-reference-date-allocated-by-companies-house
Optional.
foreign_company_details.accounts object Foreign company account information. Optional.
foreign_company_details.accounts.account_period_from object Date account period starts under parent law. Optional.
foreign_company_details.accounts.account_period_from.day integer Day on which accounting period starts under parent law. Optional.
foreign_company_details.accounts.account_period_from.month integer Month in which accounting period starts under parent law. Optional.
foreign_company_details.accounts.account_period_to object Date account period ends under parent law. Optional.
foreign_company_details.accounts.account_period_to.day integer Day on which accounting period ends under parent law. Optional.
foreign_company_details.accounts.account_period_to.month integer Month in which accounting period ends under parent law. Optional.
foreign_company_details.accounts.must_file_within object Time allowed from period end for disclosure of accounts under parent law. Optional.
foreign_company_details.accounts.must_file_within.months integer Number of months within which to file. Optional.
foreign_company_details.business_activity string Type of business undertaken by the company. Optional.
foreign_company_details.company_type string Legal form of the company in the country of incorporation. Optional.
foreign_company_details.governed_by string Law governing the company in country of incorporation. Optional.
foreign_company_details.is_a_credit_finance_institution boolean Is it a financial or credit institution. Optional.
foreign_company_details.originating_registry object Company origin informations Optional.
foreign_company_details.originating_registry.country string Country in which company was incorporated. Optional.
foreign_company_details.originating_registry.name string Identity of register in country of incorporation. Optional.
foreign_company_details.registration_number string Registration number in company of incorporation. Optional.
has_been_liquidated boolean The flag indicating if the company has been liquidated in the past. Optional.
has_charges boolean The flag indicating if the company has any charges. Optional.
has_insolvency_history boolean The flag indicating if the company has insolvency history. Optional.
is_community_interest_company boolean The flag indicating if the company is a Community Interest Company. Optional.
jurisdiction string The jurisdiction specifies the political body responsible for the company. Possible values are:
  • england-wales
  • wales
  • scotland
  • northern-ireland
  • european-union
  • united-kingdom
  • england
  • noneu
last_full_members_list_date date The date of last full members list update. Optional.
links object A set of URLs related to the resource, including self.
links.charges string The URL of the company's charge resource Optional.
links.filing_history string The URL of the company's filing history list resource. Optional.
links.insolvency string The URL of the company's insolvency list resource Optional.
links.officers string The URL of the company's officer list resource. Optional.
links.persons_with_significant_control string The URL of the company's persons with significant control list resource. Optional.
links.persons_with_significant_control_statements string The URL of the company's persons with significant control statements list resource. Optional.
links.registers string The URL of the registers resource for this company Optional.
links.self string The URL of the resource.
partial_data_available string Returned if Companies House is not the primary source of data for this company.

For enumeration descriptions see partial_data_available section in the enumeration mappings.

Possible values are:
  • full-data-available-from-financial-conduct-authority
  • full-data-available-from-department-of-the-economy
  • full-data-available-from-the-company
Optional.
previous_company_names[] list The previous names of this company. Optional.
previous_company_names[].ceased_on date The date on which the company name ceased.
previous_company_names[].effective_from date The date from which the company name was effective.
previous_company_names[].name string The previous company name
registered_office_address object The address of the company's registered office. Optional.
registered_office_address.address_line_1 string The first line of the address. Optional.
registered_office_address.address_line_2 string The second line of the address. Optional.
registered_office_address.care_of string The care of name. Optional.
registered_office_address.country string The country. Possible values are:
  • Wales
  • England
  • Scotland
  • Great Britain
  • Not specified
  • United Kingdom
  • Northern Ireland
Optional.
registered_office_address.locality string The locality e.g London. Optional.
registered_office_address.po_box string The post-office box number. Optional.
registered_office_address.postal_code string The postal code e.g CF14 3UZ. Optional.
registered_office_address.premises string The property name or number. Optional.
registered_office_address.region string The region e.g Surrey. Optional.
registered_office_is_in_dispute boolean Flag indicating registered office address as been replaced. Optional.
sic_codes Array SIC codes for this company. Optional.
type string The type of the company.

For enumeration descriptions see company_type section in the enumeration mappings.

Possible values are:
  • private-unlimited
  • ltd
  • plc
  • old-public-company
  • private-limited-guarant-nsc-limited-exemption
  • limited-partnership
  • private-limited-guarant-nsc
  • converted-or-closed
  • private-unlimited-nsc
  • private-limited-shares-section-30-exemption
  • assurance-company
  • oversea-company
  • eeig
  • icvc-securities
  • icvc-warrant
  • icvc-umbrella
  • industrial-and-provident-society
  • northern-ireland
  • northern-ireland-other
  • llp
  • royal-charter
  • investment-company-with-variable-capital
  • unregistered-company
  • llp
  • other
  • european-public-limited-liability-company-se
undeliverable_registered_office_address boolean Flag indicating whether post can be delivered to the registered office. Optional.