> 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-documents.md).

# List documents

### Input

User needs to provide `ekrn` number to get available documents for given company

<table><thead><tr><th width="218">Attribute</th><th width="171">Type</th><th>Description</th></tr></thead><tbody><tr><td>ekrn</td><td>String</td><td>The European Company Registration Number (ECRN)</td></tr><tr><td>startDate</td><td>String</td><td>Start date of document validity (optional)</td></tr><tr><td>endDate</td><td>String</td><td>End date of document validity  (optional)</td></tr><tr><td>includeRealEstateData</td><td>Boolean</td><td>Flag indicating whether the documents should include real estate data  (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                     |
| --------- | ---------------- | ------------------------------- |
| orderId   | String           | Unique identifier for the order |
| documents | Array of Objects | List of documents               |

**Documents**

| Attribute   | Type    | Description                                  |
| ----------- | ------- | -------------------------------------------- |
| documentId  | Integer | Unique identifier for the document           |
| file        | String  | Name of the document file                    |
| validFrom   | String  | Start date of document validity              |
| validTo     | String  | End date of document validity                |
| isCorrected | Boolean | Flag indicating if the document is corrected |

<pre class="language-json"><code class="lang-json"><strong>{
</strong>    "transparenzregister": {
        "orderId": "123456789",
        "documents": [{
            "documentId": 1,
            "file": "doc.pdf",
            "validFrom": "2024-07-22",
            "validTo": "2024-07-22",
            "isCorrected": true
        }]
    }
}
</code></pre>