# Get Neuron Deregistrations

Returns neuron deregistration records with the subnet, UID, keys and metrics at deregistration.

_Source: https://beta.taostats.io/docs/api-reference/subnet/get-subnet-neuron-deregistration_

_Last reviewed: 2026-09-18_

```http
GET https://api.taostats.io/api/subnet/neuron/deregistration/v1
```

Requires an API key in the `Authorization` header.

Returns neuron deregistration records with the subnet, UID, keys and metrics at deregistration. Filter by subnet, UID, hotkey or block and time ranges.

## Try it

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

### Examples

List recent neuron deregistrations in subnet 19

```text
https://api.taostats.io/api/subnet/neuron/deregistration/v1?netuid=19&order=block_number_desc&limit=50
```

### Code samples

**cURL**

```bash
curl -H "Authorization: <YOUR_API_KEY>" \
  "https://api.taostats.io/api/subnet/neuron/deregistration/v1?netuid=19&limit=50&order=block_number_desc"
```

**JavaScript**

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

**Python**

```python
import requests

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `netuid` | query | `integer (int32)` |  | Subnet |
| `uid` | query | `integer (int32)` |  | Neuron ID |
| `hotkey` | query | `string` |  | SS58 or hex format |
| `block_number` | query | `integer (int32)` |  | The exact block number |
| `block_start` | query | `integer (int32)` |  | Start of block range (inclusive) |
| `block_end` | query | `integer (int32)` |  | End of block range (inclusive) |
| `timestamp_start` | query | `integer (int64)` |  | Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) |
| `timestamp_end` | query | `integer (int64)` |  | End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) |
| `page` | query | `integer (int32)` |  | The page number of the response. |
| `limit` | query | `integer (int32)` |  | The number of responses. max is 200, |
| `order` | query | `string` |  | One of `block_number_asc`, `block_number_desc`, `timestamp_asc`, `timestamp_desc`. |

## Responses

### `200` — Subnet neuron deregistrations retrieved successfully

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `data` | `array` | Yes |  |
| `data[].block_number` | `integer (int32)` | Yes |  |
| `data[].coldkey` | `object` | Yes |  |
| `data[].coldkey.hex` | `string` | Yes | The hex format of the hot key |
| `data[].coldkey.ss58` | `string` | Yes | The SS58 format of the hot key |
| `data[].emission` | `string` | Yes |  |
| `data[].hotkey` | `object` | Yes |  |
| `data[].hotkey.hex` | `string` | Yes | The hex format of the hot key |
| `data[].hotkey.ss58` | `string` | Yes | The SS58 format of the hot key |
| `data[].incentive` | `string` | Yes |  |
| `data[].netuid` | `integer (int32)` | Yes |  |
| `data[].timestamp` | `string (date-time)` | Yes |  |
| `data[].uid` | `integer (int32)` | Yes |  |
| `data[].was_drained` | `boolean` | 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 |  |

**Example response**

```json
{
  "data": [
    {
      "block_number": 4107358,
      "coldkey": {
        "hex": "0xf4a3bf793d82cb19e0822cc4836d9a8818786900b29e8f7d66f4da1c6c17171d",
        "ss58": "5HbUBeLHB4EYw8VHc6RCDD5S1CBD3ewpunpNqYVxegE8yzL2"
      },
      "emission": "1219773",
      "hotkey": {
        "hex": "0x44b51b68b1776162a2543e3bfafb8f7ebf53dd0a634da6086520b3818dcc1829",
        "ss58": "5DcnuvnVM4mRv1rzQKTDakfDssvoSru1spwQod8N2hM6m96y"
      },
      "incentive": "0.0018921187151903563",
      "netuid": 42,
      "timestamp": "2024-10-23T16:57:12Z",
      "uid": 221,
      "was_drained": true
    },
    {
      "block_number": 4107355,
      "coldkey": {
        "hex": "0xe017e76ac567238ba995a832fbf9f409edfc60156ad5c0357bd2b67bb99f7635",
        "ss58": "5H8XgeEHysDRH1zUsYiA2SFRV2jUUMPFp14QxYmuEXSMmDsd"
      },
      "emission": "5782681",
      "hotkey": {
        "hex": "0xfc9cdc3d99ce3776759cbfa457b10babd4e7d7ab7ae97c4c3c4780f2b4f3e805",
        "ss58": "5HmvXC5okhfaUd6XHsn8Bv5jyC565zj6mid5NZNqa8c2FSPX"
      },
      "incentive": "0.00205996795605401694",
      "netuid": 6,
      "timestamp": "2024-10-23T16:56:36Z",
      "uid": 9,
      "was_drained": false
    }
  ],
  "pagination": {
    "current_page": 1,
    "next_page": 2,
    "per_page": 50,
    "prev_page": null,
    "total_items": 291123,
    "total_pages": 5823
  }
}
```

**Response details**

```text
  {
      "block_number": 5453841,
      "timestamp": "2025-04-29T00:01:48Z",
      "netuid": 35,
      "uid": 255,
      "hotkey": {
        "ss58": "5FEiiNJJ3aQjAC2cjfxn8QdmRpPgVpdY5aSUtXUVqD33WxvJ",
        "hex": "0x8c5809f7685bfd7ce2d099a146376c6da772727d02b8f4a2c308c04740851f21"
      },
      "coldkey": {
        "ss58": "5GuPwazTiK9CXgLcfpA38kPGaoTqAVSXFnygMHqpyoTpsdER",
        "hex": "0xd613a6924b9da5c3ec4bb10f78c498d486f07d008a2fc3f71c2a1b3cdaea1c60"
      },
      "incentive": "0.00019836728465705348",
      "emission": "30777733", as rao
      "was_drained": true
    },
```

### Other responses

| Status | Meaning |
| --- | --- |
| `400` | Bad request |
| `404` | Subnet neuron deregistrations 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).