---
title: "List bank accounts"
description: "Retrieve the bank accounts Qashio knows about for your company, so transactions can be coded to the right account in your ledger."
source: https://developers.qashio.com/v2/reference/get-public-v1-erp-bank-accounts/
---

# List bank accounts

`GET /public/v1/erp/bank_accounts`

Requires a Bearer access token.

**Purpose.** Retrieve the bank accounts Qashio knows about for your company, so transactions can be
coded to the right account in your ledger.

**Description.** Returns a paginated list of bank accounts synced from your accounting system, newest
first. Each record carries both the Qashio identifier and the `remote_id` your own system uses, which
is the field to key on when writing data back. Supports filtering by name, remote id, status,
deletion state and sync timestamps — use the `updated_at_from` / `updated_at_to` window to pull only
what has changed since your last run.

**Input (query).**

| Parameter | Type | Description |
| --- | --- | --- |
| `page` | integer | Page number, 1-based. Default `1` |
| `page_size` | integer | Records per page. Default `10` |
| `remote_id` | string | Identifier in your accounting system. Partial match |
| `remote_name` | string | Account name. Partial match |
| `status` | string | `draft`, `active`, `inactive` |
| `is_deleted` | string | `true` or `false` |
| `created_at_from` / `created_at_to` | date | Creation window, `YYYY-MM-DD`. Send both |
| `updated_at_from` / `updated_at_to` | date | Last-change window, `YYYY-MM-DD`. Send both |

**Output.** Array of bank accounts, plus `pagination`.

| Field | Type | Description |
| --- | --- | --- |
| `id` | string | Qashio identifier (UUID) |
| `remote_id` | string | Identifier in your accounting system |
| `remote_name` | string | Account name as held in your system |
| `account_type` | string | Account classification, e.g. `Savings` |
| `account_number` | string | Bank account number |
| `reconciliation_account` | boolean | Whether this account is used for reconciliation |
| `status` | string | `draft`, `active` or `inactive` |
| `is_deleted` | boolean | Whether the record is marked deleted upstream |
| `created_at` / `updated_at` | string | ISO 8601 timestamps |

**Errors.** `400`, `401`, `403`.

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `page` | integer | no | Page number, 1-based. Default `1` |
| `page_size` | integer | no | Records per page. Default `10` |
| `remote_id` | string | no | Identifier in your accounting system. Partial match |
| `remote_name` | string | no | Account name. Partial match |
| `status` | string | no | `draft`, `active`, `inactive` |
| `is_deleted` | string | no | `true` or `false` |
| `created_at_from` | date | no | Creation window, `YYYY-MM-DD`. Send both |
| `created_at_to` | date | no | Creation window, `YYYY-MM-DD`. Send both |
| `updated_at_from` | date | no | Last-change window, `YYYY-MM-DD`. Send both |
| `updated_at_to` | date | no | Last-change window, `YYYY-MM-DD`. Send both |

### Example request

```bash
curl -X GET 'https://api.qashio.com/public/v1/erp/bank_accounts?page=1&page_size=20' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer <access_token>'
```

### Example response (200)

```json
{
  "status_code": 200,
  "success": true,
  "data": [
    {
      "id": "73a772d7-35b8-41a9-8d25-8ac4aab2145e",
      "remote_name": "Qashio Bank - 1",
      "remote_id": "295",
      "account_type": "Savings",
      "account_number": "160104",
      "reconciliation_account": false,
      "status": "active",
      "is_deleted": false,
      "updated_at": "2026-08-06T07:30:44.941Z",
      "created_at": "2026-08-06T07:30:44.941Z"
    }
  ],
  "meta": {
    "request_id": "3adb2d16090c7b3bdbde3b326a814b30",
    "timestamp": "2026-09-09T10:07:52.143Z"
  },
  "pagination": {
    "page": 1,
    "page_size": 20,
    "total_pages": 1,
    "total_records": 7,
    "has_next": false,
    "has_previous": false
  }
}
```

### Errors

- `401` Unauthorized - missing or invalid Bearer token