# Token Holdings and Balance

{% hint style="warning" %}
Remember, for a given call to check the account holdings or an individual balance you need to be aware whether an account ID is valid for a given environment. As an example, the amount of accounts on testnet far exceeds that of mainnet, thus you may receive errors if you try to pass an incorrect accounts into different environments.
{% endhint %}

This returns back to Balance for a given token that belongs to a given account, you can use this as an alternative to balance lookups on mirror nodes, if balance requests are critical.

## Get Token Balance

<mark style="color:blue;">`GET`</mark> `https://hedera-serverless-consensus.vercel.app/api/account/:id/:token_id`

This endpoint allows you to get the token balance of a given account for a particular environment.

#### Path Parameters

| Name                                        | Type   | Description                |
| ------------------------------------------- | ------ | -------------------------- |
| <mark style="color:red;">\*</mark>          | String | account id in 0.0.x format |
| token\_id<mark style="color:red;">\*</mark> | String | token id in 0.0.x format   |

#### Query Parameters

| Name     | Type   | Description                         |
| -------- | ------ | ----------------------------------- |
| decimals | Number | Set the number of expected decimals |

{% tabs %}
{% tab title="200 Account balance response" %}

```
{
    "data": {
        "balance": "10000"
    }
}
```

{% endtab %}

{% tab title="401 Will ask to include a api-key, if invalid will return with "Unable to validate with the supplied 'x-api-key'"" %}

```
{
    "reason": "Please set \"x-api-key\" in your header"
}
```

{% endtab %}

{% tab title="500: Internal Server Error Known issue: Account ID is not valid" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}

Perhaps you just want to know whether an account holds particular tokens, this could be helpful if you are a building service that requires one or many tokens (like NFTs) to be held to unlock access to particular feature of your service.

## Get Account Holdings

<mark style="color:blue;">`GET`</mark> `https://hedera-serverless-consensus.vercel.app/api/account/:id/holdings/:token_ids`

This endpoint allows you to know if a given account holds many different tokens or NFTS.

#### Path Parameters

| Name                                         | Type   | Description                          |
| -------------------------------------------- | ------ | ------------------------------------ |
| <mark style="color:red;">\*</mark>           | String | account id in 0.0.x format           |
| token\_ids<mark style="color:red;">\*</mark> | String | token id in 0.0.x,0.0.y,0.0.z format |

{% tabs %}
{% tab title="200 Account balance response" %}

```
{
    "data": {
        "balance": "10000"
    }
}
```

{% endtab %}

{% tab title="401 Will ask to include a api-key, if invalid will return with "Unable to validate with the supplied 'x-api-key'"" %}

```
{
    "reason": "Please set \"x-api-key\" in your header"
}
```

{% endtab %}

{% tab title="500: Internal Server Error Known issue: Account ID is not valid" %}

```javascript
{
    // Response
}
```

{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.trust.enterprises/rest-api/tokens/token-holdings-and-balance.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.