> For the complete documentation index, see [llms.txt](https://docs.transactionlink.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.transactionlink.io/docs/v1/integrations/companies-house/public-data-api/company-profile.md).

# 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

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

### Accounts

| Attribute                                             | Type    | Description                                              |
| ----------------------------------------------------- | ------- | -------------------------------------------------------- |
| [accountingReferenceDate](#accounting-reference-date) | object  | The Accounting Reference Date (ARD) of the company.      |
| [lastAccounts](#last-accounts)                        | 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

<table><thead><tr><th width="283.3333333333333">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>confirmationLastMadeUpTo</td><td>date</td><td>The date to which the last confirmation statement was made.</td></tr><tr><td>confirmationNextDue</td><td>date</td><td>The date by which the next confirmation statement must be received.</td></tr><tr><td>confirmationNextMadeUpTo</td><td>date</td><td>The date to which the next confirmation statement should be made up to.</td></tr><tr><td>confirmationOverdue</td><td>boolean</td><td>Flag indicating if the confirmation statement is overdue.</td></tr></tbody></table>

### Foreign Company Details

<table><thead><tr><th width="288">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><a href="#foreign-company-detail-accounting-requirement">accountingRequirement</a></td><td>object</td><td>Accounts requirement.</td></tr><tr><td>accounts</td><td>object</td><td>Foreign company account information.</td></tr><tr><td>businessActivity</td><td>string</td><td>Type of business undertaken by the company.</td></tr><tr><td>companyType</td><td>string</td><td>Legal form of the company in the country of incorporation.</td></tr><tr><td>governedBy</td><td>string</td><td>Law governing the company in country of incorporation.</td></tr><tr><td>isACreditFinanceInstitution</td><td>boolean</td><td>Is it a financial or credit institution.</td></tr><tr><td>originatingRegistry</td><td>object</td><td>Company origin informations.</td></tr></tbody></table>

### Foreign Company Detail Accounting Requirement

<table><thead><tr><th width="284.3333333333333">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>foreignAccountType</td><td>string</td><td>Type of accounting requirement that applies to foreign company.</td></tr><tr><td>termsOfAccountPublication</td><td>string</td><td>Describes how the publication date is derived for foreign company.</td></tr></tbody></table>

### Foreign Company Detail Accounts

| Attribute                                                                    | Type    | Description                                                                    |
| ---------------------------------------------------------------------------- | ------- | ------------------------------------------------------------------------------ |
| [accountPeriodFrom](#foreign-company-detail-account-period-from)             | object  | Date account period starts under parent law.                                   |
| [accountPeriodTo](#foreign-company-detail-account-period-to)                 | object  | Date account period ends under parent law.                                     |
| [mustFileWithin](#foreign-company-detail-account-must-file-within)           | 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](#foreign-company-detail-accounts-originating-registry) | 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

<table><thead><tr><th width="324">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>personsWithSignificantControl</td><td>string</td><td>The link of the persons with significant control list resource.</td></tr><tr><td>personsWithSignificantControlStatements</td><td>string</td><td>The link of the persons with significant control statements list resource.</td></tr><tr><td>registers</td><td>string</td><td>The link of the registers resource for this company.</td></tr><tr><td>self</td><td>string</td><td>The link of the resource.</td></tr></tbody></table>

### 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

<pre><code>{
  "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."
    }
  ],
<strong>  "registeredOfficeAddress": {
</strong>    "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
<strong>}
</strong></code></pre>