GET
/api/v2/banks/listDanh sách ngân hàng hỗ trợ
API truy xuất danh sách 60+ ngân hàng Việt Nam, biểu tượng vector SVG, logo VietQR, mã BIN, mã SWIFT và trạng thái hỗ trợ tra cứu. Sử dụng phương thức GET chuẩn RESTful.
Endpoint
GET
https://api.tracuubank.net/api/v2/banks/listMẫu Request & Response
bash
curl -X GET "https://api.tracuubank.net/api/v2/banks/list?bank_code=VCB" \
-H "Content-Type: application/json"Tham số Lọc & Tìm kiếm (Query Params / JSON Body)
| Tham số | Bắt buộc | Kiểu | Mô tả |
|---|---|---|---|
| bank_code / code | Tùy chọn | string | Lọc theo mã ngân hàng (VD: VCB, MB, TCB) |
| bin | Tùy chọn | string | number | Lọc theo mã định danh BIN (VD: 970436) |
| short_name / name | Tùy chọn | string | Lọc theo tên viết tắt hoặc tên tiếng Việt |
| lookup_supported | Tùy chọn | boolean | number | Lọc danh sách ngân hàng có hỗ trợ tra cứu tên tự động (1 hoặc true) |
200: Success response
json
{
"code": 200,
"success": true,
"msg": "Success",
"total": 1,
"data": [
{
"id": "1",
"name": "Ngân hàng TMCP Ngoại Thương Việt Nam",
"code": "VCB",
"bin": "970436",
"short_name": "Vietcombank",
"logo_url": "https://api.vietqr.io/img/VCB.png",
"icon_url": "https://api.tracuubank.net/assets/images/bank-icons/VCB.svg",
"lookup_supported": 1,
"swift_code": "BFTVVNVX"
}
],
"timestamp": 1791298500000
}