Companies House Public Data API: companyProfile

Methods

get - Company profile

Resource

{
    "accounts": {
        "accounting_reference_date": {
            "day": "integer",
            "month": "integer"
        },
        "last_accounts": {
            "made_up_to": "date",
            "type": {}
        },
        "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": {
        "persons_with_significant_control": "string",
        "persons_with_significant_control_statements": "string",
        "registers": "string",
        "self": "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",
    "service_address": {
        "address_line_1": "string",
        "address_line_2": "string",
        "care_of": "string",
        "country": "string",
        "locality": "string",
        "po_box": "string",
        "postal_code": "string",
        "region": "string"
    },
    "sic_codes": [
        "string"
    ],
    "super_secure_managing_officer_count": "integer",
    "type": "string",
    "undeliverable_registered_office_address": "boolean"
}

Properties

Name	Type	Description	Additional
accounts	object	Company accounts information.	Optional
accounts.accounting_reference_date	object	The Accounting Reference Date (ARD) of the company.
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	The date the last company accounts were made up to.
accounts.last_accounts.type	object	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` `no-accounts-type-available` `audited-abridged` `unaudited-abridged`
accounts.next_due	date	The date the next company accounts are due.	Optional
accounts.next_made_up_to	date	The date the next company accounts should be made up to.
accounts.overdue	boolean	Flag indicating if the company accounts are 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.	Optional
branch_company_details.parent_company_number	string	Parent company number.	Optional
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` `registered` `removed` `closed` `open`
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 (N.B. refers to the Annual Statement where type is registered-overseas-entity)	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, dissolved or removed. Please refer to company status to determine which.	Optional
date_of_creation	date	The date when the company was created.
etag	string	The ETag of the resource.	Optional
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.persons_with_significant_control	string	The URL of the persons with significant control list resource.	Optional
links.persons_with_significant_control_statements	string	The URL of the 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.
previous_company_names[]	array	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
service_address	object	The correspondence address of a Registered overseas entity	Optional
service_address.address_line_1	string	The first line of the address.	Optional
service_address.address_line_2	string	The second line of the address.	Optional
service_address.care_of	string	The care of name.	Optional
service_address.country	string	The country e.g. United Kingdom.	Optional
service_address.locality	string	The locality e.g London.	Optional
service_address.po_box	string	The post-office box number.	Optional
service_address.postal_code	string	The postal code e.g CF14 3UZ.	Optional
service_address.region	string	The region e.g Surrey.	Optional
sic_codes[]	array of string	SIC codes for this company.	Optional
super_secure_managing_officer_count	integer	The total count of super secure managing officers for a `registered-overseas-entity`.	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` `protected-cell-company` `assurance-company` `oversea-company` `eeig` `icvc-securities` `icvc-warrant` `icvc-umbrella` `registered-society-non-jurisdictional` `industrial-and-provident-society` `northern-ireland` `northern-ireland-other` `royal-charter` `investment-company-with-variable-capital` `unregistered-company` `llp` `other` `european-public-limited-liability-company-se` `uk-establishment` `scottish-partnership` `charitable-incorporated-organisation` `scottish-charitable-incorporated-organisation` `further-education-or-sixth-form-college-corporation` `registered-overseas-entity`
undeliverable_registered_office_address	boolean	Flag indicating whether post can be delivered to the registered office.	Optional

companyProfile resource

Methods

Resource

Properties