# Get List of Accounts

### Service Description <a href="#service-description" id="service-description"></a>

Use this service to retrieve a list of your accounts held with LHV Bank UK. The service returns key account details in a simplified format and includes both active and closed accounts.&#x20;

Only current accounts are included; VIBANs and Indirect Scheme Participant accounts are excluded.&#x20;

### Request <a href="#request" id="request"></a>

`GET` <https://connect.lhv.com/accounts/list>

#### Parameters <a href="#parameters" id="parameters"></a>

<table><thead><tr><th>Name</th><th width="172.8203125">Value</th><th>Description</th></tr></thead><tbody><tr><td>pageNumber</td><td><code>integer</code></td><td>Required. Page number of results to return.</td></tr><tr><td>pageSize</td><td><code>integer</code></td><td>Number of results per page. Maximum page size is 100. Default value is 100</td></tr><tr><td>includeClosedAccounts</td><td><code>boolean</code></td><td>If <code>true</code>, accounts with CLOSED (Deleted) status are returned. Default value is <code>true</code></td></tr></tbody></table>

#### Headers  <a href="#body" id="body"></a>

Applicable for service providers and service provider users.

| Name           | Description      |
| -------------- | ---------------- |
| Client-Code    | `customer value` |
| Client-Country | `customer value` |

#### Body <a href="#body" id="body"></a>

This request doesn't have a body.

### Response

{% tabs %}
{% tab title="200 - list of accounts" %}
{% hint style="success" %}
OK
{% endhint %}

```json
{
    "Data": {
        "Account": [
            {
                "Status": "Enabled",
                "Currency": "GBP",
                "OpeningDate": "2025-04-24",
                "Account": [
                    {
                        "SchemeName": "IBAN",
                        "Identification": "GB11LHVB04031400001234",
                        "Name": "Connect Demo Customer 1"
                    },
                    {
                        "SchemeName": "SortCodeAccountNumber",
                        "Identification": "04031400001234",
                        "Name": "Connect Demo Customer 1"
                    }
                ],
                "Servicer": {
                    "SchemeName": "BICFI",
                    "Identification": "LHVBGB2L"
                }
            },
            {
                "Status": "Enabled",
                "Currency": "GBP",
                "Nickname": "Main Operating Account",
                "OpeningDate": "2024-06-20",
                "Account": [
                    {
                        "SchemeName": "IBAN",
                        "Identification": "GB11LHVB04031400004321",
                        "Name": "Connect Demo Customer 1"
                    },
                    {
                        "SchemeName": "SortCodeAccountNumber",
                        "Identification": "04031400004321",
                        "Name": "Connect Demo Customer 1"
                    }
                ],
                "Servicer": {
                    "SchemeName": "BICFI",
                    "Identification": "LHVBGB2L"
                }
            },
            {
                "Status": "Enabled",
                "Currency": "GBP",
                "Nickname": "Payments Account 1",
                "OpeningDate": "2024-04-01",
                "Account": [
                    {
                        "SchemeName": "IBAN",
                        "Identification": "GB11LHVB04031400002234",
                        "Name": "Connect Demo Customer 1"
                    },
                    {
                        "SchemeName": "SortCodeAccountNumber",
                        "Identification": "04031400002234",
                        "Name": "Connect Demo Customer 1"
                    }
                ],
                "Servicer": {
                    "SchemeName": "BICFI",
                    "Identification": "LHVBGB2L"
                }
            },
            {
                "Status": "Enabled",
                "Currency": "GBP",
                "Nickname": "Payments Account 2",
                "OpeningDate": "2024-04-01",
                "Account": [
                    {
                        "SchemeName": "IBAN",
                        "Identification": "GB59LHVB04031400000475",
                        "Name": "Connect Demo Customer 1"
                    },
                    {
                        "SchemeName": "SortCodeAccountNumber",
                        "Identification": "04031400000475",
                        "Name": "Connect Demo Customer 1"
                    }
                ],
                "Servicer": {
                    "SchemeName": "BICFI",
                    "Identification": "LHVBGB2L"
                }
            }        
        ]
    },
    "Links": {},
    "Meta": {}
}
```

{% endtab %}

{% tab title="403 - error" %}
{% hint style="danger" %}
Error
{% endhint %}

{% code overflow="wrap" %}

```json
{
    "Message": "User is not authorized to access this resource with an explicit deny in an identity-based policy"
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

<br>