Skip to main content
POST

Authorizations

Authorization
string
header
required

Base64-encode your API key and pass it. Enter the API key as the username and leave the password empty.

Body

application/json

An account to look up

bankCode
string
required

Three-digit KFTC standard bank code. See the bank account holder guide for supported banks.

Pattern: ^\d{3}$
Example:

"088"

accountNumber
string
required

Account number. Hyphens are allowed. Without hyphens it must be 6 to 20 digits.

Pattern: ^-*(?:\d-*){6,20}$
Example:

"1000000001"

amount
integer<int64>

Deposit amount in KRW for an amount-verified virtual account. Leave it empty for a regular account.

Required range: x >= 1

Response

Lookup succeeded

Single account holder lookup result

bankCode
string
required

The bank code you sent

accountNumber
string
required

Account number with hyphens removed

holderName
string
required

Account holder name