Documentation / API reference / Identity
Get Identity History
Reference
Last reviewed 2026-09-18
Returns historical account identities with their block numbers and timestamps.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
address | query | string | SS58 or hex format | |
page | query | integer (int32) | ||
limit | query | integer (int32) | ||
order | query | string | One of block_number_asc, block_number_desc, timestamp_asc, timestamp_desc. |
Responses
200 — Identity retrieved successfully
| Field | Type | Required | Description |
|---|---|---|---|
data | array | Yes | |
data[].additional | string, nullable | ||
data[].address | object | Yes | |
data[].address.hex | string | Yes | The hex format of the hot key |
data[].address.ss58 | string | Yes | The SS58 format of the hot key |
data[].block_number | integer (int32) | Yes | |
data[].description | string, nullable | ||
data[].discord | string, nullable | ||
data[].github_repo | string, nullable | ||
data[].image | string, nullable | ||
data[].name | string, nullable | ||
data[].timestamp | string (date-time) | Yes | |
data[].url | 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 |
Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Identity not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.