Title: Get the Available Balance of a Sub-Reseller Account Using the API  
PrimaryCategory: Account Management &amp; Billing  
Type: Procedural  
Tags: sub-reseller, balance, API, authentication, reseller-id, selling currency  
Source UI Terms: auth-userid, api-key, reseller-id  
Source Reference: Get the Available Balance of a Sub-Reseller Account Using the API  

Prerequisites:  
- You must have valid authentication credentials (auth-userid and api-key).  
- You must know the reseller-id of the sub-reseller whose balance you want to retrieve.  

Steps:  
1) Use the HTTP GET method to call the endpoint:  
   `https://test.httpapi.com/api/billing/reseller-balance.json`  
2) Include the following required parameters in the request URL query string:  
   - `auth-userid` (Integer): Your authentication user ID.  
   - `api-key` (String): Your API key for authentication.  
   - `reseller-id` (Integer): The reseller ID of the Sub-Reseller whose balance you want to fetch.  

Response:  
- On success, the API returns a JSON hash map containing:  
  - `sellingcurrencysymbol`: Selling currency symbol of the parent reseller.  
  - `sellingcurrencybalance`: Available balance amount in the selling currency.  
  - `sellingcurrencylockedbalance`: Locked amount in the selling currency.  
- On error, the response includes a `status` key with value `ERROR` and an error message.  

Summary:  
You can retrieve the available balance of a sub-reseller account using a GET API call with the required authentication and reseller ID, receiving the balance details in the parent&#39;s selling currency.  

Evaluation Pairs:  
Q: What parameters are required to get a sub-reseller&#39;s available balance via API?  
A: You need to provide `auth-userid`, `api-key`, and the `reseller-id` of the sub-reseller.  

Q: What HTTP method should be used to fetch the sub-reseller balance?  
A: Use the GET method.  

Q: What information does the API response include when requesting a sub-reseller&#39;s available balance?  
A: It includes the selling currency symbol, available balance amount, and locked balance amount of the sub-reseller&#39;s selling currency.

<p>When you want to retrieve the available balance details for a sub-reseller account. This article explains the required parameters and API request format for fetching sub-reseller balance information in the selling currency.</p>
<div class="region region-content">
<div class="hidden"> </div>
<div class="block block-core block-page-title-block" id="block-twostates-page-title">
<div class="content">
<h1 class="title page-title"><span class="field field--name-title field--type-string field--label-hidden">Getting a Sub-Reseller&#39;s Available Balance</span></h1>
<div id="toc" style="display: block;">
<div id="toc_content">
<p> </p>
<a name="heading_0"></a>Description</div>
</div>
</div>
</div>
<div class="node__content clearfix">
<div class="layout layout--onecol">
<div class="layout__region layout__region--content">
<div class="clearfix text-formatted field field--name-body field--type-text-with-summary field--label-hidden field__item">
<p>Gets the Available Balance of the specified Sub-Reseller.</p>
<h2><a name="heading_1"></a>Parameters</h2>
<table class="codetable"><tbody><tr><th colspan="1" rowspan="1">Name</th><th colspan="1" rowspan="1">Data Type</th><th colspan="1" rowspan="1">Required / Optional</th><th colspan="1" rowspan="1">Description</th></tr><tr><td colspan="1" rowspan="1">auth-userid</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Authentication Parameter</td></tr><tr><td colspan="1" rowspan="1">api-key</td><td colspan="1" rowspan="1">String</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Authentication Parameter</td></tr><tr><td colspan="1" rowspan="1">reseller-id</td><td colspan="1" rowspan="1">Integer</td><td colspan="1" rowspan="1">Required</td><td colspan="1" rowspan="1">Reseller Id of the Sub-Reseller whose Available Balance is to be fetched</td></tr></tbody></table>
<h2><a name="heading_2"></a>HTTP Method</h2>
<p>GET</p>
<h2><a name="heading_3"></a>Example Test URL Request</h2>
<p><code>https://test.httpapi.com/api/billing/reseller-balance.json?auth-userid=0&amp;api-key=key&amp;reseller-id=0</code></p>
<h2><a name="heading_4"></a>Response</h2>
<p>Returns a hash map of the Sub-Reseller&#39;s Available Balance containing the below details:</p>
<ul><li>
<p>Selling Currency Symbol of the Parent Reseller (sellingcurrencysymbol)</p>
</li><li>
<p>Available Balance Amount in the Selling Currency (sellingcurrencybalance)</p>
</li><li>
<p>Locked Amount in the Selling Currency (sellingcurrencylockedbalance)</p>
</li></ul>
<p>In case of any errors, a <strong>status</strong> key with value as <em>ERROR</em> alongwith an error message will be returned.</p>
</div>
</div>
</div>
</div>
<div class="mychild-topics"> </div>
</div>
<div class="seedetailssection"> </div>

When you want to retrieve the available balance details for a sub-reseller account. This article explains the required parameters and API request format for fetching sub-reseller balance information in the selling currency.

Name	Data Type	Required / Optional	Description
auth-userid	Integer	Required	Authentication Parameter
api-key	String	Required	Authentication Parameter
reseller-id	Integer	Required	Reseller Id of the Sub-Reseller whose Available Balance is to be fetched