---
title: "Lista e llogarive bankare"
operation_id: "api.v1.bank-accounts.list"
method: GET
path: "/api/v1/bank-accounts"
group: "Llogaritë bankare"
api_version: "v1"
authenticated: true
canonical: "https://fature.al/api-reference/endpoints/api-v1-bank-accounts-list.html"
---

# Lista e llogarive bankare

Part of the [fature.al API](/api-reference/index.html) documentation.

## GET /api/v1/bank-accounts

Merr listen e llogarive bankare aktive te kompanise me faqosje dhe filtrim me tekst.

Full URL: `https://fature.al/api/v1/bank-accounts`

API version: `v1`.

Authentication: required (bearer token).

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `limit` | integer | no | Numri i llogarive per faqe (max 100). Defaults to `20`. |
| `offset` | integer | no | Nga cila llogari te fillohet. Defaults to `0`. |
| `query` | string | no | Kerkim ne emer te bankes, IBAN, SWIFT, mbajtes ose shenime. |

### Example request

```bash
curl -X GET 'https://fature.al/api/v1/bank-accounts' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'X-Client-Id: YOUR_CLIENT_ID' \
  -H 'X-Client-Secret: YOUR_CLIENT_SECRET' \
  -H 'Accept: application/json'
```

### Responses

**200** — OK

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean |  |
| `data` | object |  |
| `data.items` | array |  |
| `data.items[].id` | integer |  |
| `data.items[].bank_name` | string, nullable |  |
| `data.items[].iban` | string, nullable |  |
| `data.items[].swift` | string, nullable |  |
| `data.items[].holder` | string, nullable |  |
| `data.items[].currency_code` | string, nullable |  |
| `data.items[].is_default` | boolean |  |
| `data.items[].notes` | string, nullable |  |
| `data.items[].valid_from` | string, nullable |  |
| `data.items[].valid_to` | string, nullable |  |
| `data.items[].created_at` | string, nullable |  |
| `data.pagination` | object |  |
| `data.pagination.records` | integer |  |
| `data.pagination.total` | integer |  |
| `data.pagination.limit` | integer |  |
| `data.pagination.offset` | integer |  |

```json
{
    "status": true,
    "data": {
        "items": [
            {
                "id": 1,
                "bank_name": "Jane Doe",
                "iban": "iban",
                "swift": "swift",
                "holder": "holder",
                "currency_code": "USD",
                "is_default": true,
                "notes": "notes",
                "valid_from": "valid from",
                "valid_to": "valid to",
                "created_at": "created at"
            }
        ],
        "pagination": {
            "records": 1,
            "total": 4200,
            "limit": 25,
            "offset": 0
        }
    }
}
```

**429** — Kufiri i kerkesave u arrit. Kufiri per endpoint kthen zarfin standard te gabimit; kufiri i pergjithshem kthen vetem `message` bashke me header-in `Retry-After`.

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean | Always false. A successful response carries `status: true` and a `data` object instead |
| `message` | string | The exception message. Empty when the failure carries no exception of its own |
| `errors` | array | Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message` |

```json
{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}
```

**500** — Gabim i papritur ne server.

| Field | Type | Description |
| --- | --- | --- |
| `status` | boolean | Always false. A successful response carries `status: true` and a `data` object instead |
| `message` | string | The exception message. Empty when the failure carries no exception of its own |
| `errors` | array | Messages to show the operator or to log. Absent when the failure has nothing to add beyond `message` |

```json
{
    "status": true,
    "message": "Hello there",
    "errors": [
        "errors"
    ]
}
```