Fetch Balance - Razorpay

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/banking_balances

{
  "entity": "collection",
  "count": 4,
  "items": [
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "409001396356",
      "account_type": "current_account",
      "bank_name": "RBL Bank",
      "bank_code": "RATN",
      "amount": 186682638,
      "available_amount": 186682638,
      "refreshed_at": 1721889110
    },
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "002281300049209",
      "account_type": "current_account",
      "bank_name": "Yes Bank",
      "bank_code": "YESB",
      "amount": 10489829,
      "available_amount": 186682638,
      "refreshed_at": 1696419847
    },
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "002281300012871",
      "account_type": "fixed_deposit",
      "bank_name": "Yes Bank",
      "bank_code": "YESB",
      "amount": 10489829,
      "available_amount": 186682638,
      "refreshed_at": 1696419847
    },
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "984539953520846",
      "account_type": "razorpayx_lite",
      "bank_name": null,
      "bank": null,
      "amount": 1029,
      "available_amount": 1029,
      "refreshed_at": 1729847660
    }
  ]
}

{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "The selected account type is invalid.",
    "source": "business",
    "step": null,
    "reason": "input_validation_failed",
    "metadata": {},
    "field": "account_type"
  }
}

GET

banking_balances

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/banking_balances

{
  "entity": "collection",
  "count": 4,
  "items": [
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "409001396356",
      "account_type": "current_account",
      "bank_name": "RBL Bank",
      "bank_code": "RATN",
      "amount": 186682638,
      "available_amount": 186682638,
      "refreshed_at": 1721889110
    },
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "002281300049209",
      "account_type": "current_account",
      "bank_name": "Yes Bank",
      "bank_code": "YESB",
      "amount": 10489829,
      "available_amount": 186682638,
      "refreshed_at": 1696419847
    },
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "002281300012871",
      "account_type": "fixed_deposit",
      "bank_name": "Yes Bank",
      "bank_code": "YESB",
      "amount": 10489829,
      "available_amount": 186682638,
      "refreshed_at": 1696419847
    },
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "984539953520846",
      "account_type": "razorpayx_lite",
      "bank_name": null,
      "bank": null,
      "amount": 1029,
      "available_amount": 1029,
      "refreshed_at": 1729847660
    }
  ]
}

{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "The selected account type is invalid.",
    "source": "business",
    "step": null,
    "reason": "input_validation_failed",
    "metadata": {},
    "field": "account_type"
  }
}

Available in🇮🇳 India🇺🇸 United States

Use this endpoint to retrieve the balances of all accounts.

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/banking_balances

{
  "entity": "collection",
  "count": 4,
  "items": [
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "409001396356",
      "account_type": "current_account",
      "bank_name": "RBL Bank",
      "bank_code": "RATN",
      "amount": 186682638,
      "available_amount": 186682638,
      "refreshed_at": 1721889110
    },
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "002281300049209",
      "account_type": "current_account",
      "bank_name": "Yes Bank",
      "bank_code": "YESB",
      "amount": 10489829,
      "available_amount": 186682638,
      "refreshed_at": 1696419847
    },
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "002281300012871",
      "account_type": "fixed_deposit",
      "bank_name": "Yes Bank",
      "bank_code": "YESB",
      "amount": 10489829,
      "available_amount": 186682638,
      "refreshed_at": 1696419847
    },
    {
      "entity": "banking_balance",
      "currency": "INR",
      "account_number": "984539953520846",
      "account_type": "razorpayx_lite",
      "bank_name": null,
      "bank": null,
      "amount": 1029,
      "available_amount": 1029,
      "refreshed_at": 1729847660
    }
  ]
}

{
  "error": {
    "code": "BAD_REQUEST_ERROR",
    "description": "The selected account type is invalid.",
    "source": "business",
    "step": null,
    "reason": "input_validation_failed",
    "metadata": {},
    "field": "account_type"
  }
}

Query Parameters

Watch Out!RazorpayX Lite is currently not available for new merchants. To set up a new RazorpayX account, refer to Current Account.

string

Filters account based on type. Possible values are current_account or razorpayx_lite. The parameter is case sensitive.

current_account: Current Accounts and Escrow Accounts
razorpayx_lite: RazorpayX Lite Accounts

string

Filters based on bank name. This should be the first four characters of IFSC for any bank. For example, RATNor YESB. The parameter is case sensitive.

integer

Number of accounts to be fetched based on the most recently refreshed balance. This can be used for pagination, in combination with skip.

Default value : 10
Maximum value : 100

integer

Numbers of balances to be skipped. This can be used for pagination, in combination with count. Default value is 0.

Response Parameters

string

The entity being returned. For example, banking_balance.

integer

Count of items being returned. For example 2.

object

Array of all accounts and their balances.

string

Returns the currency in which the balance amount is relayed. For example, INR.

long

The total INR balance amount in paise. For example, 6358629.

string

Associated account number. For example, 123456789281.

string

Returns associated account type. For example, current_account.

string

Returns the full name of the bank. For example YESB.

string

Returns bank code. This will be the first four characters of IFSC for any bank. For example YESB.

long

The latest timestamp of Razorpay fetching balance from the bank in epoch format. For example 1729847660.

long

The net withdrawable INR balance amount in paise. This will deduct any lien balance and include any OD balance on the account. For example, 6358629.

Errors

`The selected account type is invalid`

Code: 400Query parameter account_type is incorrectly passed.Solution: Enter the account_type as current_account or razorpayx_lite only. The query parameter is case sensitive.

`Invalid channel name: rbl`

Code: 400Query parameter bank_code is incorrectly passed.Solution: Enter the bank_code in the correct format. This should be the first four characters of IFSC for any bank, and is case sensitive.

`The count may not be greater than 100`

Code: 400The count passed in the query parameter is greater than 100.Solution: The maximum value that can be passed here is 100.

`The count must be an integer`

Code: 400The count passed in the query parameter is not an integerSolution: Enter only integer values.

`Authentication failed`

Code: 401Incorrect Key or Secret.Solution: Enter the correct Key and Secret as per the request body.

`Throttling Error`

Code: 429The server is processing too many requests at once and is unable to process your request.Solution: Retry the request after some time.

`We are facing some trouble completing your request at the moment. Please try again shortly.`

Code: 500Internal Server Error. The server has encountered a situation it does not know how to handle.Solution: Retry the request after some time.

`Bad Gateway`

Code: 502The server got an invalid response while working as a gateway to get a response needed to handle the request.Solution: Retry the request after some time.

`Service Unavailable`

Code: 503The server is not ready to handle the request. Common causes are a server that is down for maintenance or is overloaded.Solution: Retry the request after some time.

`Gateway Timeout`

Code: 504This error response is given when the server acts as a gateway and cannot get a timely response.Solution: Retry the request after some time.

​Query Parameters

​Response Parameters

​Errors

Query Parameters

Response Parameters

Errors