Documentation / API reference / Subnet
Get Subnet Identity
Reference
Last reviewed 2026-09-18
Returns subnet identities with names, descriptions, logos and contact links. Filter by netuid to retrieve a particular subnet's identity.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
netuid | query | integer (int32) | ||
page | query | integer (int32) | The page number of the response. | |
limit | query | integer (int32) | The number of responses. max is 200, |
Responses
200 — Subnet identities retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].additional | string, nullable | |
data[].description | string, nullable | |
data[].discord | string, nullable | |
data[].github_repo | string, nullable | |
data[].logo_url | string, nullable | |
data[].netuid | integer (int32) | Yes |
data[].subnet_contact | string, nullable | |
data[].subnet_name | string | Yes |
data[].subnet_url | string, nullable | |
data[].summary | string, nullable | |
data[].tags | array, nullable | |
data[].tags[] | string | |
data[].twitter | string, nullable | |
pagination | object | Yes |
pagination.current_page | integer (int32) | Yes |
pagination.next_page | integer (int32), nullable | |
pagination.per_page | integer (int32) | Yes |
pagination.prev_page | integer (int32), nullable | |
pagination.total_items | integer (int32) | Yes |
pagination.total_pages | integer (int32) | Yes |
Example response
json
{
"data": [
{
"additional": null,
"description": null,
"discord": null,
"github_repo": null,
"netuid": 0,
"subnet_contact": null,
"subnet_name": "Root",
"subnet_url": null
},
{
"additional": "",
"description": "Apex intelligence",
"discord": "macrocrux",
"github_repo": "https://github.com/macrocosm-os/prompting",
"netuid": 1,
"subnet_contact": "[email protected]",
"subnet_name": "Apex",
"subnet_url": "https://www.macrocosmos.ai/sn1"
}
],
"pagination": {
"current_page": 1,
"next_page": null,
"per_page": 1024,
"prev_page": null,
"total_items": 93,
"total_pages": 1
}
}Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Subnet identities not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.