GET/api/v2/banks/list

Danh 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

GEThttps://api.tracuubank.net/api/v2/banks/list

Mẫ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ộcKiểuMô tả
bank_code / codeTùy chọnstringLọc theo mã ngân hàng (VD: VCB, MB, TCB)
binTùy chọnstring | numberLọc theo mã định danh BIN (VD: 970436)
short_name / nameTùy chọnstringLọc theo tên viết tắt hoặc tên tiếng Việt
lookup_supportedTùy chọnboolean | numberLọ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
}