# Trade Credit Balances

## Gets accounts' trade credit balance

<mark style="color:blue;">`GET`</mark> `https://api.aquanow.io/users/v1/tradeCreditBalance`

#### Query Parameters

<table><thead><tr><th>Name</th><th width="209">Type</th><th>Description</th></tr></thead><tbody><tr><td>accountId<mark style="color:red;">*</mark></td><td>String</td><td>The accountId to fetch the balances for</td></tr></tbody></table>

#### Headers

| Name                                          | Type   | Description                                                                                                                                                        |
| --------------------------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| x-api-key<mark style="color:red;">\*</mark>   | String | <p><code>{{x-api-key}}</code></p><p>API Auth Key</p>                                                                                                               |
| x-signature<mark style="color:red;">\*</mark> | String | <p><code>49c6260c194f4d7ed5cb917dc70b9821673246b2abc1cf28f05df6a75fd24181e00f8e57b321d15ae45db58b3bffe27a</code></p><p>Signature created using your API secret</p> |
| x-nonce<mark style="color:red;">\*</mark>     | Number | <p><code>1657731573930</code></p><p>Timestamp in millisecond</p>                                                                                                   |

{% tabs %}
{% tab title="200: OK Get trade credit balance by accountId" %}
Returns a [TradeCreditBalanceObject](https://docs.aquanow.io/aquanow/data-objects-and-statuses/accounts-objects#tradecreditbalanceobject)

```json
{
    "unutilizedCreditUSD": 962103.3538520804,
    "accountId": "CA1000051R",
    "updatedAt": 1713377094457,
    "username": "user_username",
    "creditLimitUsd": 1000000
}
```

{% endtab %}

{% tab title="400: Bad Request accountId is not provided" %}

```javascript
{
    "message": "Please provide an accountId"
}
```

{% endtab %}

{% tab title="404: Not Found accountId does not exist" %}

```javascript
{
    "message": "Credit balance does not exist"
}
```

{% endtab %}
{% endtabs %}