This endpoint checks if a bank account exists and retrieves basic details—such as account name and number. It does not indicate whether the account is blocked, dormant, or has any other issues from the bank's side.

curl -X GET \
  'BASE_URL/api/v1/account_validation?bank=danamon&account=000001137298' \
  -H 'Accept: application/json' \
  -H 'Authorization: Basic AUTH_STRING' \
  -H 'Cache-Control: no-cache'

{
  "id": "e2c60cbd3c7a453bbc843b1f2b2e9027",
  "account_name": "Danamon Simulator A",
  "account_no": "000001137298",
  "bank_name": "danamon"
}

{
    "id": "e2c60cbd3c7a453bbc843b1f2b2e9025",
    "error_message": "An error occured when doing account validation",
    "errors": {
        "account": [
            "Account does not exist"
        ]
    }
}

{
    "error_message": "You are not authorized to perform this action",
    "errors": {
        "account": [
            "You are not authorized to perform this action"
        ]
    }
}

{
    "id": "e2c60cbd3c7a453bbc843b1f2b2e9023",
    "error_message": "An error occured when doing account validation",
    "errors": {
        "account": [
            "Bank account validation is currently unavailable"
        ]
    }
}

Here is the list of error_message that you can get from this API

Response code	Error Message	Notes
400	Account does not exist	Account does not exist in bank system
400	Account is dormant	Account has become dormant in bank system
400	Account is closed	Account has closed in bank system
401	You are not authorized to perform this action	Authentication error
503	Bank account validation is currently unavailable	System error
429	Too many requests	Merchant send too many request within timeframe (1 second)

Rate Limit
For Create Payout, Approve Payout, and Account Validation endpoints, a rate limit of 50 requests per second (RPS) per merchant will be enforced in production.

HTTP

GET BASE_URL/api/v1/account_validation?bank=#{BANK_NAME}&account=#{BANK_ACCOUNT}

Request Parameters

Parameter	Description
bank	Bank code. Case Sensitive, lowercase
account	Account number

Response Parameters

Parameter	Description
bank_name	Bank name of partner's bank account
account_name	Account name of partner's bank account
account_no	Account number of partner's bank account
id	Unique ID of the Account Validation