# List Companies

### Input

<table><thead><tr><th width="228">Attribute</th><th width="110">Type</th><th>Description</th><th>Required</th></tr></thead><tbody><tr><td>registrationNumber</td><td>String</td><td>Registration number of the searched company</td><td>Only of these is requred.</td></tr><tr><td>name</td><td>String</td><td>The name of the searched company</td><td>Only of these is requred.</td></tr></tbody></table>

### Input Example

```
{
    "registrationNumber": "12345"
}
```

### Output

### Company Details

| Attribute          | Type           | Description                                     |
| ------------------ | -------------- | ----------------------------------------------- |
| id                 | String         | Unique identifier of the company                |
| name               | String         | Name of the company                             |
| registrationNumber | String         | Registration number of the company              |
| registrationDate   | String         | Registration date of the company                |
| state              | String         | State of the company's registration             |
| suffix             | String         | Suffix of the company                           |
| address            | String         | Complete address of the company                 |
| street             | String         | Street address of the company                   |
| postcode           | String         | Postal code of the company                      |
| locality           | String         | Locality of the company                         |
| previousNames      | Array\<Object> | List of previous names used by the company      |
| lastModified       | String         | Last modified date of the company's information |

### Previous Names

| Attribute     | Type   | Description                                                |
| ------------- | ------ | ---------------------------------------------------------- |
| uuid          | String | Unique identifier of the previous name record              |
| previousName  | String | Name previously used by the company                        |
| effectiveDate | String | Date when the previous name was effective                  |
| companyUuid   | String | Unique identifier of the company associated with this name |
| company       | String | Name of the company associated with this previous name     |

### Output Example

```
[
  {
    "id": "1a2b3c4d",
    "name": "Example Corp",
    "registration_number": "REG123456",
    "registration_date": "2020-01-01",
    "state": "Active",
    "suffix": "Ltd",
    "address": "123 Business Road",
    "street": "Business Avenue",
    "postcode": "BIZ123",
    "locality": "Business City",
    "previous_names": [
      {
        "uuid": "pre1a2b3c",
        "previous_name": "Old Corp",
        "effective_date": "2019-12-31",
        "company_uuid": "1a2b3c4d",
        "company": "Example Corp"
      }
    ],
    "last_modified": "2023-10-01"
  },
  {
    "id": "5e6f7g8h",
    "name": "Sample LLC",
    "registration_number": "REG654321",
    "registration_date": "2018-05-15",
    "state": "Active",
    "suffix": "LLC",
    "address": "456 Sample Street",
    "street": "Sample Boulevard",
    "postcode": "SMP456",
    "locality": "Sample Town",
    "previous_names": [
      {
        "uuid": "pre9w8x7y",
        "previous_name": "Test LLC",
        "effective_date": "2018-05-14",
        "company_uuid": "5e6f7g8h",
        "company": "Sample LLC"
      }
    ],
    "last_modified": "2023-09-20"
  }
]
```

####


---

# 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/malta-business-registry/company-profile/list-companies.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.
