Sila API Docs | Sila Banking and Payments API

Welcome to the Sila API!


Requests bank account balance data from an end-users linked bank account.

The /get_account_balance endpoint will return available_balance and current_balance reported by the user entity's financial institution.


In the sandbox environment $100.00 is used for the available bank account balance, $110 for the current bank account balance.



Both authsignature and usersignature headers are required for this request.

The account_name key is a nickname of one of the user's linked bank accounts for which balance data should be fetched.

Note - We recently renamed the field auth_handle to app_handle. For backward compatibility, auth_handle is still valid but has been removed from our documentation.

POST /0.2/get_account_balance HTTP/1.1
Content-Type: application/json

  "header": {
    "created": 1234567890, 
    "app_handle": "handle.silamoney.eth", 
    "version": "0.2",
    "crypto": "ETH", 
    "reference": "<your unique id>"
  "account_name": "default"


HTTP/1.1 200 OK

  "success": true,
  "status": "SUCCESS",
  "available_balance": 100,
  "current_balance": 110,
  "masked_account_number": "0000",
  "routing_number": 123456789,
  "account_name": "default"
const res = await Sila.getAccountBalance(

// Success Response Object

console.log(res.statusCode); // 200
console.log(; // TRUE
console.log(; // Available balance
console.log(; // Current balance
console.log(; // Masked account number
console.log(; // Routing number
console.log(; // Account name
payload = {
    "user_handle": "user.silamoney.eth",
    "account_name": "default"

response = User.getAccountBalance(app, payload, user_private_key)

### Success Response Object

    "success": True,
    "available_balance": 100,
    "current_balance": 110,
    "masked_account_number": "0000",
    "routing_number": 123456789,
    "account_name": "default",
    "status": 'SUCCESS',
    "status_code": 200

### Failure Response Object

    "success": False,
    "message": "Error message"
ApiResponse response = api.getAccountBalance(DefaultConfigurations.getUserHandle(),
                DefaultConfigurations.getUserPrivateKey(), "account name");

// Success Response Object
System.out.println(response.getStatusCode()); // 200
System.out.println(((AccountBalanceResponse)response.getData()).getAccountName()); // Account name
System.out.println(((AccountBalanceResponse)response.getData()).getCurrentBalance()); // Current Balance
System.out.println(((AccountBalanceResponse)response.getData()).getMaskedAccountNumber()); // Masked Account Number
System.out.println(((AccountBalanceResponse)response.getData()).getRoutingNumber()); // Account routing number
$userHandle = 'user.silamoney.eth';
$userPrivateKey = 'some private key'; // Hex format
$accountName = 'Custom Account Name';
$response = $client->getAccountBalance($userHandle, $userPrivateKey, $accountName);

// Success 200
echo $response->getStatusCode(); // 200
echo $response->getData()->success; // TRUE
echo $response->getData()->availableBalance; // Available balance
echo $response->getData()->currentBalance; // Current balance
echo $response->getData()->maskedAccountNumber; // Masked account number
echo $response->getData()->routingNumber; // Routing number
echo $response->getData()->accountName; // Account name
ApiResponse<object> response = api.GetAccountBalance(userHandle, walletPrivateKey, accountName);

// Success Object Response

Console.WriteLine(response.StatusCode); // 200
var parsedData = (GetAccountBalanceResponse)response.Data;
Console.WriteLine(parsedData.Success); // TRUE
Console.WriteLine(parsedData.AvailableBalance); // Available balance
Console.WriteLine(parsedData.CurrentBalance); // Current balance
Console.WriteLine(parsedData.MaskedAccountNumber); // Masked account number
Console.WriteLine(parsedData.RoutingNumber); // Routing number
Console.WriteLine(parsedData.AccountName); // Account name
headerJSON objectRequired. Requires these keys in JSON format: created, app_handle, user_handle. See the /check_handle endpoint for the complete list of fields in this object.
account_nameStringRequired. Max length 40
The account_name must match a bank account associated with the user_handle; check /get_accounts endpoint for a list of these.
Example: Custom Account Name


Status CodeKey in ResponseDescription
200N/ASuccessfully fetched balance data for linked account.
400validation_detailsBad request format - check validation_details for more information.
400link_statusAccount either has not completed verification with Plaid or was not linked with Plaid.
400N/AUnable to get bank account balance details. Original login credentials might have expired or the bank account may have been closed. Can attempt to link account again to try to fetch balance details.
403N/Aauthsignature or usersignature header was absent or incorrect.
404N/Aaccount_name not found for current user.


Be aware!

Only accounts linked with Plaid's Instant Auth, eg. username and password, are eligible. Moreover, not all U.S. financial institutions support /get_account_balance.

Updated 2 months ago


Requests bank account balance data from an end-users linked bank account.

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.