# NFT Holder List

```
https://api.vechainstats.com/v2/nft/holder-list
    ?id=exoworlds
    &threshold=100
    &page=
    &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                                                                                                                     |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| id                    | The ID of a NFT project, can be found in the NFT Token List endpoint                                                            |
| treshold (*optional*) | Setting this to an `Integer` value limits the response addresses to those that hold an amount equal or above the treshold value |
| page                  | the `integer` page number, the available pages are shown in the response meta fields                                            |
| {% endtab %}          |                                                                                                                                 |

{% tab title="Response" %}

```
{
    "status": {
        "success": true,
        "message": "OK"
    },
    "data": {
        "0xe860cef926e5e76e0e88fdc762417a582f849c27": 512,
        "0xaee087732f2c4a81e13f08ced9933f825c1daf6a": 317,
        "0xc71757050454d093513fcafd2eb41e4ca844b6a1": 303,
        "0x5a48bcf53a73665cd905d1157825665cfce856ad": 262,
        "0x2b57dbd11c5e9b3981d39b5452f44765f33faee6": 260,
        "0x2c43caa2b1be58b3e1dc286f291c7da9a40a4245": 258,
        "0xa979e29f5a7bcc852477c196272769be047313bb": 193,
        "0xc4afdf8e62921a7243fb3449d9d5fbb98dd5cf27": 134,
        "0xf1b501976af0ba3f169f80796daba21e0df921d6": 129,
        "0x5aa85851a9078b0738316085e7d66dbd43e46fbe": 117,
        "0x1b311eecd4cf97d4f90229e0d6ab1b7d7458dec4": 115,
        "0x91fc5056704812ae6c21935bfd3ddba61e63ddc3": 110,
        "0xd3c9cf42bf4bdb6a8b88fac4ad95a8aaa3a8e934": 106,
        "0x7cf42dbcd56f6d23d99d524ffc174955a060993e": 104,
        "0x1e9368a3cb7eaf7d86b23aedabe52da341dbe509": 103,
        "0x3c84b20e0e236fecb999c006ef08ecbc59879bd9": 101
    },
    "meta": {
        "count": 16,
        "id": "exoworlds",
        "threshold": 100,
        "name": "ExoWorlds",
        "contract": "0x3473c5282057d7beda96c1ce0fe708e890764009",
        "holders": 896,
        "timestamp": 1696257011
    }
}
```

{% endtab %}
{% endtabs %}