Company Profile

Overview

Company profile endpoint provides a concise and comprehensive overview of a registered company. This includes details such as the company's name, registration number, status, address, directors, shareholders, financial information, and historical changes. Accessing this endpoint offers valuable insights into a company's current status and historical evolution.

Output

Property Name	Type	Description
accounts	object	Company account information.
annualReturn	object	Annual return information. This member is only returned if a confirmation statement has not be filed.
branchCompanyDetails	object	UK branch of a foreign company.
canFile	boolean	Flag indicating whether this company can file.
companyName	string	The name of the company.
companyNumber	string	The number of the company.
companyStatus	string	The status of the company.
companyStatusDetail	string	Extra details about the status of the company.
confirmationStatement	object	Confirmation statement information (N.B. refers to the Annual Statement where type is registered-overseas-entity)
dateOfCessation	date	The date which the company was converted/closed, dissolved, or removed.
dateOfCreation	date	The date when the company was created.
etag	string	The ETag of the resource.
foreignCompanyDetails	object	Foreign company details.
hasBeenLiquidated	boolean	The flag indicating if the company has been liquidated in the past.
hasCharges	boolean	The flag indicating if the company has any charges.
hasInsolvencyHistory	boolean	The flag indicating if the company has insolvency history.
isCommunityInterestCompany	boolean	The flag indicating if the company is a Community Interest Company.
jurisdiction	string	The jurisdiction specifies the political body responsible for the company.
lastFullMembersListDate	date	The date of the last full members list update.
links	object	A set of URLs related to the resource, including self.
previousCompanyNames	array<object>	The previous names of this company.
registeredOfficeAddress	object	The address of the company's registered office.
registeredOfficeIsInDispute	boolean	Flag indicating registered office address has been replaced.
serviceAddress	object	The correspondence address of a Registered overseas entity
sicCodes[]	array	SIC codes for this company.
superSecureManagingOfficerCount	integer	The total count of super secure managing officers.
type	string	The type of the company.
undeliverableRegisteredOfficeAddress	boolean	Flag indicating whether post can be delivered to the registered office.

Accounts

Attribute	Type	Description
accountingReferenceDate	object	The Accounting Reference Date (ARD) of the company.
lastAccounts	object	The last company accounts filed.
nextDue	date	The date the next company accounts are due.
nextMadeUpTo	date	The date the next company accounts should be made up to.
overdue	boolean	Flag indicating if the company accounts are overdue.

Accounting Reference Date

Attribute	Type	Description
day	integer	The day of the accounting reference date.
month	integer	The month of the accounting reference date.

Last accounts

Attribute	Type	Description
madeUpTo	date	The date the last company accounts were made up to.
type	string	The type of the last company accounts filed.

Annual Return

Attribute	Type	Description
lastMadeUpTo	date	The date the last annual return was made up to.
nextDue	date	The date the next annual return is due.
nextMadeUpTo	date	The date the next annual return should be made up to.
annualReturnOverdue	boolean	Flag indicating if the annual return is overdue.

Branch Company Details

Attribute	Type	Description
businessActivity	string	Type of business undertaken by the UK establishment.
parentCompanyName	string	Parent company name.
parentCompanyNumber	string	Parent company number.

Confirmation Statement

Attribute	Type	Description
confirmationLastMadeUpTo	date	The date to which the last confirmation statement was made.
confirmationNextDue	date	The date by which the next confirmation statement must be received.
confirmationNextMadeUpTo	date	The date to which the next confirmation statement should be made up to.
confirmationOverdue	boolean	Flag indicating if the confirmation statement is overdue.

Foreign Company Details

Attribute	Type	Description
accountingRequirement	object	Accounts requirement.
accounts	object	Foreign company account information.
businessActivity	string	Type of business undertaken by the company.
companyType	string	Legal form of the company in the country of incorporation.
governedBy	string	Law governing the company in country of incorporation.
isACreditFinanceInstitution	boolean	Is it a financial or credit institution.
originatingRegistry	object	Company origin informations.

Foreign Company Detail Accounting Requirement

Attribute	Type	Description
foreignAccountType	string	Type of accounting requirement that applies to foreign company.
termsOfAccountPublication	string	Describes how the publication date is derived for foreign company.

Foreign Company Detail Accounts

Attribute	Type	Description
accountPeriodFrom	object	Date account period starts under parent law.
accountPeriodTo	object	Date account period ends under parent law.
mustFileWithin	object	Date account period ends under parent law.
businessActivity	string	Type of business undertaken by the foreign company.
companyType	string	Legal form of the company in the country of incorporation for foreign company.
governedBy	string	Law governing the company in the country of incorporation for foreign company.
isACreditFinanceInstitution	boolean	Is it a financial or credit institution for foreign company.
originatingRegistry	object	Company origin informations.
registrationNumber	string	Registration number in the country of incorporation for foreign company.

Foreign Company Detail Accounts Period From

Attribute	Type	Description
day	number	Day on which accounting period starts under parent law for foreign company.
month	number	Month in which accounting period starts under parent law for foreign company.

Foreign Company Detail Accounts Period To

Attribute	Type	Description
day	number	Day on which accounting period ends under parent law for foreign company.
month	number	Month in which accounting period ends under parent law for foreign company.

Foreign Company Detail Accounts Must File Within

Attribute	Type	Description
months	number	Number of months within which to file for foreign company.

Foreign Company Detail Accounts Originating Registry

Attribute	Type	Description
country	string	Country in which company was incorporated for foreign company.
name	string	Identity of register in the country of incorporation for foreign company.

Links

Attribute	Type	Description
personsWithSignificantControl	string	The link of the persons with significant control list resource.
personsWithSignificantControlStatements	string	The link of the persons with significant control statements list resource.
registers	string	The link of the registers resource for this company.
self	string	The link of the resource.

Previous Company Names

Attribute	Type	Description
ceasedOn	date	The date on which the company name ceased.
effectiveFrom	date	The date from which the company name was effective.
name	string	The previous company name.

Registered Office Address

Attribute	Type	Description
addressLine1	string	The first line of the registered office address.
addressLine2	string	The second line of the registered office address.
careOf	string	The care of name for registered office.
country	string	The country for registered office.
locality	string	The locality for registered office.
poBox	string	The post-office box number for registered office.
postalCode	string	The postal code for registered office.
premises	string	The property name or number for registered office.
region	string	The region for registered office.

Service Address

Attribute	Type	Description
addressLine1	string	The first line of the service address.
addressLine2	string	The second line of the service address.
careOf	string	The care of name for service address.
country	string	The country for service address.
locality	string	The locality for service address.
poBox	string	The post-office box number for service address.
postalCode	string	The postal code for service address.
region	string	The region for service address.

Example

{
  "accounts": {
    "accountingReferenceDate": {
      "day": 31,
      "month": 12
    },
    "lastAccounts": {
      "madeUpTo": "2022-12-31",
      "type": "full"
    },
    "nextDue": "2023-12-31",
    "nextMadeUpTo": "2023-12-31",
    "overdue": false
  },
  "annualReturn": {
    "lastMadeUpTo": "2022-12-31",
    "nextDue": "2023-12-31",
    "nextMadeUpTo": "2023-12-31",
    "annualReturnOverdue": false
  },
  "branchCompanyDetails": {
    "businessActivity": "Business activity description",
    "parentCompanyName": "Parent Company Ltd.",
    "parentCompanyNumber": "12345678"
  },
  "canFile": true,
  "companyName": "Sample Company",
  "companyNumber": "12345678",
  "companyStatus": "active",
  "companyStatusDetail": "Company is in good standing",
  "confirmationStatement": {
    "confirmationLastMadeUpTo": "2022-12-31",
    "confirmationNextDue": "2023-12-31",
    "confirmationNextMadeUpTo": "2023-12-31",
    "confirmationOverdue": false
  },
  "dateOfCessation": null,
  "dateOfCreation": "2020-01-01",
  "etag": "abcdefgh123456",
  "foreignCompanyDetails": {
    "accountingRequirement": {
      "foreignAccountType": "dormant",
      "termsOfAccountPublication": "unaudited"
    },
    "accounts": {
      "accountPeriodFrom": {
        "day": 1,
        "month": 1
      },
      "accountPeriodTo":  {
        "day": 31,
        "month": 12
      },
      "mustFileWithin": {
        "months": 12
      },
      "businessActivity": "Foreign business activity description",
      "companyType": "limited",
      "governedBy": "Foreign legal governance",
      "isACreditFinanceInstitution": false,
      "originatingRegistry": {
        "country": "Foreign Country",
        "name": "Foreign Registry"
      },
      "registrationNumber": "98765432"
    }
  },
  "hasBeenLiquidated": false,
  "hasCharges": true,
  "hasInsolvencyHistory": false,
  "isCommunityInterestCompany": false,
  "jurisdiction": "United Kingdom",
  "lastFullMembersListDate": "2022-12-31",
  "links": {
    "personsWithSignificantControl": "https://example.com/psc",
    "personsWithSignificantControlStatements": "https://example.com/psc-statements",
    "registers": "https://example.com/registers",
    "self": "https://example.com/company/12345678"
  },
  "previousCompanyNames": [
    {
      "ceasedOn": "2020-12-31",
      "effectiveFrom": "2020-01-01",
      "name": "Previous Company Name Ltd."
    }
  ],
  "registeredOfficeAddress": {
    "addressLine1": "123 Main Street",
    "addressLine2": "Suite 456",
    "careOf": "Company Secretary",
    "country": "United Kingdom",
    "locality": "Cityville",
    "poBox": "PO Box 789",
    "postalCode": "12345",
    "premises": "Premises Building",
    "region": "Regionshire"
  },
  "registeredOfficeIsInDispute": false,
  "serviceAddress": {
    "addressLine1": "456 Service Avenue",
    "addressLine2": null,
    "careOf": "Director's Office",
    "country": "United Kingdom",
    "locality": "Townville",
    "poBox": null,
    "postalCode": "67890",
    "region": "Countyshire"
  },
  "sicCodes": ["12345", "67890"],
  "superSecureManagingOfficerCount": 3,
  "type": "private-limited",
  "undeliverableRegisteredOfficeAddress": false
}