> 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/transparenzregister/beneficial-owners/list-companies.md).

# List companies

List companies in registry based on search phrase

### Input

User needs to provide search phrase. The search phrase should be detailed enough to find a specific company.

<table><thead><tr><th width="175">Attribute</th><th width="259">Type</th><th>Description</th></tr></thead><tbody><tr><td>search</td><td>String</td><td>Search phrase (at least 3 characters)</td></tr><tr><td>registerNumber</td><td>String</td><td>Registration number of company (optional)</td></tr><tr><td>court</td><td>String</td><td>The district court where the company is registered (optional)</td></tr><tr><td>registry</td><td>String</td><td>The type of registry (e.g., VR, HRA) where the company is registered (optional)</td></tr><tr><td>password</td><td>String</td><td>API access password</td></tr><tr><td>email</td><td>String</td><td>API access email</td></tr><tr><td>apiKey</td><td>String </td><td>API key</td></tr></tbody></table>

### Output

| Attribute         | Type    | Description                                           |
| ----------------- | ------- | ----------------------------------------------------- |
| companyName       | String  | The name of the company                               |
| headquarters      | String  | The location of the company's main office             |
| registerType      | String  | The type of register the company is listed in         |
| registerNumber    | String  | The registration number of the company                |
| ekrn              | String  | The European Company Registration Number (ECRN)       |
| isDeleted         | Boolean | Indicates whether the company record is deleted       |
| registerCourtName | String  | The name of the court where the company is registered |
| registerCourtKey  | String  | The key identifier for the register court             |

```json
{
    "transparenzregister": [{
            "companyName": "CH Testtrüst 6 & Testsöhnê",
            "headquarters": "Hamburg",
            "registerType": "Handelsregister",
            "registerNumber": "HRB 123456",
            "ekrn": "DE384738734064",
            "isDeleted": false,
            "registerCourtName": "Amtsgericht Hamburg",
            "registerCourtKey": "AGHH"
        },
        {
            "companyName": "CH Testgésellschaft 3",
            "headquarters": "Köln",
            "registerType": "Handelsregister",
            "registerNumber": "HRB 654321",
            "ekrn": "DE013400858287",
            "isDeleted": false,
            "registerCourtName": "Amtsgericht Köln",
            "registerCourtKey": "AGK"
        },
        {
            "companyName": "CH Testgestaltung 2",
            "headquarters": "Rom",
            "registerType": "Handelsregister",
            "registerNumber": "HRB 789012",
            "ekrn": "DE549513318438",
            "isDeleted": false,
            "registerCourtName": "Amtsgericht Rom",
            "registerCourtKey": "AGR"
        }
    ]
}

```