Skip to main content
GET
List banks for linking an account
Pass the two-letter country. The directory is available for the Philippines (PH) and Vietnam (VN) where the route supports one. The call uses the account’s tenant and enabled linked-bank routes, and requires v2:accounts access. It returns bank codes and names only. It does not verify account ownership or create a payout. Use the selected code as bankCode when you link a bank account.

Authorizations

Authorization
string
header
required

HTTP Basic auth. Username is the Stableyard app ID. Password is the app secret. The optional Stableyard-Version request header must match the environment pin.

Headers

Stableyard-Version
enum<string>

Optional contract-version assertion. Omit it to use the app environment's pinned version. A different supported version is accepted only after that environment is explicitly migrated.

Available options:
2026-09-09

Path Parameters

accountId
string
required

Canonical account id returned by the Accounts API.

Example:

"acct_123"

Query Parameters

country
string
required
Pattern: ^[A-Za-z]{2}$
Example:

"PH"

Response

Bank directory

country
string
required
Pattern: ^[A-Z]{2}$
currency
string
required
Pattern: ^[A-Z]{3}$
banks
object[]
required