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",
    "sic_codes": [
        "string"
    ],
    "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
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.

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 string on which the company name ceased.

previous_company_names[].effective_from date

The string 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 of string

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
  • 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
undeliverable_registered_office_address boolean

Flag indicating whether post can be delivered to the registered office.

Optional