GET /banks

List the master set of supported banks. Use this to pick a valid bankCode when creating a bank account.

The list is static (17 banks) and sorted by code. TrueWallet is handled separately and is not part of this list.

Endpoint

GET /banks

Full URL: https://api.easyslip.com/v2/banks

Authentication

Required. See Authentication Guide.

Authorization: Bearer YOUR_API_KEY

Request

No request body or query parameters required.

Type Definitions

// Response Types
interface BanksResponse {
  success: true;
  data: Bank[];
}

interface Bank {
  code: string;              // Bank code — use as `bankCode` when creating an account
  nameTh: string;            // Bank name (Thai)
  nameEn: string;            // Bank name (English)
  shortCode: string;         // Short code / abbreviation
  swiftCode: string;         // SWIFT/BIC code
  extraVerify: ExtraVerifyOption[] | null;   // supported verify options, or null
}

interface ExtraVerifyOption {
  value: string;             // send as `extraVerify` when creating/updating an account
  label: string;             // human-readable description
}

// Error Response
interface ErrorResponse {
  success: false;
  error: {
    code: string;
    message: string;
  };
}

Examples

cURL

curl -X GET https://api.easyslip.com/v2/banks \
  -H "Authorization: Bearer YOUR_API_KEY"

JavaScript

const response = await fetch('https://api.easyslip.com/v2/banks', {
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  }
});

const result = await response.json();
console.log(result.data);

PHP

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => 'https://api.easyslip.com/v2/banks',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY'
    ]
]);

$response = curl_exec($ch);
curl_close($ch);

$result = json_decode($response, true);
print_r($result['data']);

Python

import requests
import os

response = requests.get(
    'https://api.easyslip.com/v2/banks',
    headers={'Authorization': f'Bearer {os.environ["EASYSLIP_API_KEY"]}'}
)

result = response.json()
print(result['data'])

Response

Success Response (200)

{
  "success": true,
  "data": [
    {
      "code": "002",
      "nameTh": "ธนาคารกรุงเทพ",
      "nameEn": "Bangkok Bank",
      "shortCode": "BBL",
      "swiftCode": "BKKBTHBK",
      "extraVerify": [
        { "value": "NAME", "label": "ตรวจจาก ชื่อบัญชี อย่างเดียว (ไม่แนะนำ)" },
        { "value": "NUMBER", "label": "ตรวจจาก เลขบัญชี อย่างเดียว" },
        { "value": "NAME_NUMBER", "label": "ตรวจจาก เลขบัญชีและชื่อบัญชีธนาคาร" }
      ]
    },
    {
      "code": "014",
      "nameTh": "ธนาคารไทยพาณิชย์",
      "nameEn": "Siam Commercial Bank",
      "shortCode": "SCB",
      "swiftCode": "SICOTHBK",
      "extraVerify": [
        { "value": "NAME", "label": "ตรวจจาก ชื่อบัญชี อย่างเดียว (ไม่แนะนำ)" },
        { "value": "NUMBER", "label": "ตรวจจาก เลขบัญชี อย่างเดียว" },
        { "value": "NAME_NUMBER", "label": "ตรวจจาก เลขบัญชีและชื่อบัญชีธนาคาร" }
      ]
    }
  ]
}

Response Fields

Field	Type	Description
code	string	Bank code — use as bankCode when creating an account
nameTh	string	Bank name (Thai)
nameEn	string	Bank name (English)
shortCode	string	Short code / abbreviation
swiftCode	string	SWIFT/BIC code
extraVerify	ExtraVerifyOption[] | null	Verify options this bank supports, or null if it has none
extraVerify[].value	string	The value to send as extraVerify when creating/updating an account
extraVerify[].label	string	Human-readable description of the option

Error Responses

Unauthorized (401)

{
  "success": false,
  "error": {
    "code": "MISSING_API_KEY",
    "message": "Authorization header is required"
  }
}

Notes

• This endpoint does not consume quota.
• The code value is what you pass as bankCode to POST /bank-accounts.
• extraVerify lists the verify options a bank supports. Not every bank has options — some return extraVerify: null. When creating or updating an account, read this list and send one of the option values as the account's extraVerify.
• For the full reference table of bank codes, see Bank Codes.