# Get Subnet Pruning Latest

Returns the latest subnet pruning ranks, moving prices and immunity status.

_Source: https://beta.taostats.io/docs/api-reference/subnet/get-subnet-pruning-latest_

_Last reviewed: 2026-10-12_

```http
GET https://api.taostats.io/api/subnet/pruning/latest/v1
```

Requires an API key in the `Authorization` header.

> [!WARNING]
> **This API is retired on November 9, 2026**
>
> Every endpoint in this reference — every path that starts with `/api/` — stops working on **November 9, 2026**. The [new Taostats API](https://beta.taostats.io/docs/new) replaces it: same key, new paths under `https://api.taostats.io/v1/`. Move your integration to the [new API reference](https://beta.taostats.io/docs/new) before then.

Returns the latest subnet pruning ranks, moving prices and immunity status. These records describe subnet deregistration risk, not individual neuron pruning. They include the registration block and remaining immunity blocks.

## Try it

Try this request in the browser on the HTML version of this page, or use the code samples below.

### Examples

See which neurons in subnet 19 are closest to being pruned

```text
https://api.taostats.io/api/subnet/pruning/latest/v1?netuid=19&order=pruning_rank_asc&limit=20
```

### Code samples

**cURL**

```bash
curl -H "Authorization: <YOUR_API_KEY>" \
  "https://api.taostats.io/api/subnet/pruning/latest/v1?netuid=19&limit=20&order=pruning_rank_asc"
```

**JavaScript**

```js
const response = await fetch('https://api.taostats.io/api/subnet/pruning/latest/v1?netuid=19&limit=20&order=pruning_rank_asc', {
  headers: {
    Authorization: '<YOUR_API_KEY>',
  },
});
const data = await response.json();
```

**Python**

```python
import requests

response = requests.get(
    "https://api.taostats.io/api/subnet/pruning/latest/v1?netuid=19&limit=20&order=pruning_rank_asc",
    headers={"Authorization": "<YOUR_API_KEY>"},
)
data = response.json()
```

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `netuid` | query | `integer (int32)` |  |  |
| `is_immune` | query | `boolean` |  |  |
| `page` | query | `integer (int32)` |  |  |
| `limit` | query | `integer (int32)` |  |  |
| `order` | query | `string` |  | One of `pruning_rank_asc`, `pruning_rank_desc`, `netuid_asc`, `netuid_desc`, `registered_at_block_asc`, `registered_at_block_desc`, `immunity_blocks_remaining_asc`, `immunity_blocks_remaining_desc`, `is_immune_asc`, `is_immune_desc`, `moving_price_asc`, `moving_price_desc`. |

## Responses

### `200` — Subnets retrieved successfully

| Field | Type | Required |
| --- | --- | --- |
| `data` | `array` | Yes |
| `data[].block_number` | `integer (int32)` | Yes |
| `data[].immunity_blocks_remaining` | `integer (int32)` | Yes |
| `data[].is_immune` | `boolean` | Yes |
| `data[].moving_price` | `string` | Yes |
| `data[].netuid` | `integer (int32)` | Yes |
| `data[].pruning_rank` | `integer (int32)` | Yes |
| `data[].registered_at_block` | `integer (int32)` | Yes |
| `data[].timestamp` | `string (date-time)` | Yes |
| `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 |

### Other responses

| Status | Meaning |
| --- | --- |
| `400` | Bad request |
| `404` | Subnets not found |
| `500` | Internal server error |

Every request needs an `Authorization` header holding your API key — see [Getting started with the Taostats API](https://beta.taostats.io/docs/start-here/getting-started-with-taostats-api).