List Bank Accounts

List bank accounts belonging to the authenticated company via SePay API v2.

List Bank Accounts

GET

https://userapi.sepay.vn/v2/bank-accounts

Query Parameters

Parameter	Type	Description
`bank_short_name`	string	Exact match (e.g., ACB, BIDV, VPB)
`last_transaction_from`	datetime	Last transaction date -- start
`last_transaction_to`	datetime	Last transaction date -- end
`accumulated_min`	int	Minimum accumulated balance
`accumulated_max`	int	Maximum accumulated balance
`q`	string	LIKE search on `label`, `account_holder_name`, and `account_number`
`active`	string	`true`/`1` or `false`/`0`
`created_at_sort`	string	`asc` or `desc`
`last_transaction_sort`	string	`asc` or `desc`
`accumulated_sort`	string	`asc` or `desc`

Code Examples

curl --request GET \
  --url 'https://userapi.sepay.vn/v2/bank-accounts?bank_short_name=ACB&last_transaction_from=SOME_STRING_VALUE&last_transaction_to=SOME_STRING_VALUE&accumulated_min=SOME_INTEGER_VALUE&accumulated_max=SOME_INTEGER_VALUE&q=SOME_STRING_VALUE&active=SOME_STRING_VALUE&created_at_sort=SOME_STRING_VALUE&last_transaction_sort=SOME_STRING_VALUE&accumulated_sort=SOME_STRING_VALUE&page=SOME_INTEGER_VALUE&per_page=SOME_INTEGER_VALUE' \
  --header 'Authorization: Bearer REPLACE_BEARER_TOKEN'

Response

{
  "status": "success",
  "data": [
    {
      "id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
      "bank_short_name": "ACB",
      "bank_full_name": "Asia Commercial Joint Stock Bank",
      "account_number": "0123456789",
      "account_holder_name": "NGUYEN VAN A",
      "label": "Main account",
      "accumulated": 15000000,
      "last_transaction_date": "2025-01-15 09:30:00",
      "active": true,
      "bank_id": 1,
      "created_at": "2025-01-15 10:00:00",
      "updated_at": "2025-01-15 09:30:00"
    }
  ],
  "meta": {
    "pagination": {
      "total": 5,
      "per_page": 20,
      "current_page": 1,
      "last_page": 1,
      "has_more": false
    }
  }
}

Response 200 - Bank account list

{
  "status": "success",
  "data": [
    {
      "id": "f9e8d7c6-b5a4-3210-fedc-ba0987654321",
      "account_holder_name": "CONG TY CP TECH VINA",
      "account_number": "19028745631",
      "accumulated": 15000000,
      "last_transaction": "2025-08-15 09:30:00",
      "label": "TK giao dich chinh",
      "account_type": "personal",
      "active": 1,
      "created_at": "2025-01-15 10:30:00",
      "bank_short_name": "ACB",
      "bank_full_name": "Ngan hang TMCP A Chau",
      "bank_bin": "970416",
      "bank_code": "ACB"
    }
  ],
  "meta": {
    "pagination": {
      "total": 5,
      "per_page": 20,
      "current_page": 1,
      "last_page": 1,
      "has_more": false
    }
  }
}

Notes

id is the UUID of the bank account
accumulated is an integer (VND)
q searches simultaneously on label, account_holder_name, and account_number