> 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/ceidg/list-companies.md).

# List companies

List companies in registries based on search criteria

### Input

User needs to provide one of 

* `companyNumber` 
* `regon`
* `companyName`

<table><thead><tr><th width="335">Attribute</th><th width="176">Type</th><th>Description</th></tr></thead><tbody><tr><td>companyName</td><td>String</td><td>Search phrase (at least 3 characters)</td></tr><tr><td>regon</td><td>String</td><td>REGON number</td></tr><tr><td>companyNumber</td><td>String</td><td>Company number, Polish NIP</td></tr><tr><td>companyType</td><td>String</td><td><p>Company type, possible values:</p><ul><li><code>SOLE_PROPRIETORSHIP</code></li><li><code>CIVIL_COMPANY</code></li></ul></td></tr></tbody></table>

### Output

**Ceidg**

<table><thead><tr><th width="311">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td>companies</td><td><code>array</code></td><td>List of companies</td></tr><tr><td>count</td><td><code>number</code> </td><td>Results count</td></tr></tbody></table>

#### Company

<table><thead><tr><th width="316">Attribute</th><th>Type</th><th>Description</th></tr></thead><tbody><tr><td><code>id</code></td><td><code>string</code></td><td>The unique identifier of the sole proprietorship</td></tr><tr><td><code>name</code></td><td><code>string</code></td><td>The name of the sole proprietorship</td></tr><tr><td><code>registerDate</code></td><td><code>string</code></td><td>The date when the sole proprietorship was registered</td></tr><tr><td><a href="#soleproprietorship.registryaddress"><code>registryAddress</code></a></td><td><code>object</code></td><td>The address of the sole proprietorship as registered with the authorities</td></tr><tr><td><a href="#correspondenceaddress"><code>correspondenceAddress</code></a></td><td><code>object</code></td><td>The correspondence address of the sole proprietorship</td></tr><tr><td><a href="#owner"><code>owner</code></a></td><td><code>object</code></td><td>Information about the owner of the sole proprietorship</td></tr><tr><td><a href="#citizenship"><code>citizenship</code></a></td><td><code>array of objects</code></td><td>The citizenship(s) of the owner</td></tr><tr><td><a href="#activityclassifications"><code>activityClassifications</code></a></td><td><code>array of objects</code></td><td>The activity classifications of the sole proprietorship</td></tr><tr><td><code>status</code></td><td><code>string</code></td><td>The current status of the sole proprietorship</td></tr></tbody></table>

#### registryAddress

| Attribute    | Type     | Description                               |
| ------------ | -------- | ----------------------------------------- |
| `street`     | `string` | The street address of the registry        |
| `city`       | `string` | The city where the registry is located    |
| `country`    | `string` | The country where the registry is located |
| `postalCode` | `string` | The postal code of the registry           |
| `terc`       | `string` | The TERC code of the registry             |
| `simc`       | `string` | The SIMC code of the registry             |
| `ulic`       | `string` | The ULIC code of the registry             |

#### correspondenceAddress

| Attribute    | Type     | Description                                     |
| ------------ | -------- | ----------------------------------------------- |
| `street`     | `string` | The street address of the correspondence        |
| `city`       | `string` | The city where the correspondence is located    |
| `country`    | `string` | The country where the correspondence is located |
| `postalCode` | `string` | The postal code of the correspondence           |
| `terc`       | `string` | The TERC code of the correspondence             |
| `simc`       | `string` | The SIMC code of the correspondence             |
| `ulic`       | `string` | The ULIC code of the correspondence             |

#### owner

| Attribute | Type     | Description                   |
| --------- | -------- | ----------------------------- |
| `name`    | `string` | The first name of the owner   |
| `surname` | `string` | The last name of the owner    |
| `nip`     | `string` | The NIP number of the owner   |
| `regon`   | `string` | The REGON number of the owner |

#### citizenship

| Attribute | Type     | Description                                             |
| --------- | -------- | ------------------------------------------------------- |
| `symbol`  | `string` | The two-letter symbol of the citizenship                |
| `country` | `string` | The name of the country associated with the citizenship |

#### activityClassifications

| Attribute | Type     | Description                              |
| --------- | -------- | ---------------------------------------- |
| `value`   | `string` | The value of the activity classification |
| `type`    | `string` | The type of the activity classification  |

#### Example response

```json
{
    "ceidg": {
        "companies": [
            {
                "id": "84e25402-e8c0-4f11-b012-6b2f88645c8f",
                "name": "PAWEŁ NIEWOLIŃSKI, WSPÓLNIK SPÓŁKI CYWILNEJ \"PIZZA PLACE'",
                "registerDate": "2006-06-01",
                "registryAddress": {
                    "street": "ul. Gołębia 13",
                    "city": "Puszczykowo",
                    "country": "PL",
                    "postalCode": "62-040",
                    "voivodeship": "WIELKOPOLSKIE",
                    "terc": "3021021",
                    "simc": "0971376",
                    "ulic": "05761"
                },
                "correspondenceAddress": {
                    "street": "ul. Sosnowa 21",
                    "city": "Lesko",
                    "country": "PL",
                    "postalCode": "35-500",
                    "terc": "1827011",
                    "simc": "0853510"
                },
                "owner": {
                    "name": "PAWEŁ",
                    "surname": "NIEWOLIŃSKI",
                    "nip": "7772793547",
                    "regon": "300317928"
                },
                "citizenship": [],
                "activityClassifications": [],
                "status": "ACTIVE"
            },
            {
                "id": "bbbab5ed-50ec-4d92-a908-9e0d86501ed0",
                "name": "MERKATUS Krzysztof Bet, WSPÓLNIK SPÓŁKI CYWILNEJ \"PIZZA PLACE\"",
                "registerDate": "2007-10-01",
                "registryAddress": {
                    "street": "ul. Dolna Wilda 88/81",
                    "city": "Poznań",
                    "country": "PL",
                    "postalCode": "61-501",
                    "voivodeship": "WIELKOPOLSKIE",
                    "terc": "3064011",
                    "simc": "0969400"
                },
                "owner": {
                    "name": "Krzysztof",
                    "surname": "Bet",
                    "nip": "6661986395",
                    "regon": "301035149"
                },
                "citizenship": [],
                "activityClassifications": [],
                "status": "ACTIVE"
            }
        ],
        "count": 2
    }
}
```