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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.transactionlink.io/docs/v1/integrations/companies-house/public-data-api/company-profile.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.