# X-Node List

```
https://api.vechainstats.com/v2/network/xnode-list
    ?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    | Response                                                                                             |
| ------------ | ---------------------------------------------------------------------------------------------------- |
| expanded     | Either `true` or `false`. Setting this option to `true` expands the response with extra information. |
| {% endtab %} |                                                                                                      |

{% tab title="Response" %}
{% hint style="info" %}
Output below is shortened and only serves as an example
{% endhint %}

```json
{    
    "status": {
        "success": true,
        "message": "OK"
    },
        "data": {
            "0xfc87cf5b81b42ba3014dfee39d2fa97f97683af3": {
                "id": 5873,
                "type": "mjolnirx",
                "contract": "legacy"
            },
            "0x3eec8db7a8f95aee2763656e4447befbe40f5f44": {
                "id": 7,
                "type": "strengthx",
                "contract": "stargate"
            },
            "0x30abb1c2d871d59a32c6358c689242c063809112": {
                "id": 8,
                "type": "thunderx",
                "contract": "stargate"
            },
    "meta": {
        "count": 1904,
        "expanded": true,
        "timestamp": 1753715205
    }
}
```

{% endtab %}
{% endtabs %}