> For the complete documentation index, see [llms.txt](https://docs.vechainstats.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vechainstats.com/api-endpoints/nft/vip181-balance.md).

# VIP181 Balance

```
https://api.vechainstats.com/v2/nft/vip181
    ?address=0xbBDA54E57f3FfdcF3d28F402326F5DF3a1c63778
    &id=vegas_pop
    &expanded=true
    &VCS_API_KEY=your_api_key
```

{% hint style="info" %}
**Note :** This endpoint is throttled to **10 calls/minute** regardless of API Pro tier.
{% endhint %}

{% tabs %}
{% tab title="Request" %}

| Parameter       | Description                                                                                                                            |
| --------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| address         | The address for which you want to know it's token balance.                                                                             |
| id (*optional*) | The ID of a NFT project, can be found in the NFT Token List endpoint. If not set, all NFT projects with a balance over 0 are returned. |
| expanded        | Either `true` or `false`. Setting this option to `true` expands the response with extra information.                                   |
| {% endtab %}    |                                                                                                                                        |

{% tab title="Response" %}

```
{
    "status": {
        "success": true,
        "message": "OK"
    },
    "data": {
        "vegas_pop": {
            "name": "The Hive PoP",
            "amount": 0,
            "contract": "0xfb3b2f8b4f8aae9e7a24ba0bcbb6a49d344f2ef3",
            "token_ids": []
        }
    },
    "meta": {
        "address": "0xbbda54e57f3ffdcf3d28f402326f5df3a1c63778",
        "id": "vegas_pop",
        "expanded": true,
        "nfts_total": 139,
        "timestamp": 1696336252
    }
}
```

{% endtab %}
{% endtabs %}