---
title: "Returns historical information for a single validator."
method: GET
path: "/consensus/validators/{address}/history"
---

# Returns historical information for a single validator.

`GET /consensus/validators/{address}/history`

## Path parameters

- `address` string, required — An Oasis-style (bech32) address.

## Query parameters

- `limit` integer
- `offset` integer
- `from` integer
- `to` integer

## Response `200`

A JSON object containing historical information for a
validator, grouped by epoch in reverse chronological order.

- ValidatorHistory — Historical escrow balance data for a single address.
  - `total_count` integer, required — The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.
  - `is_total_count_clipped` boolean, required — Whether total_count is clipped for performance reasons.
  - `address` string — The staking address of the validator.
  - `history` ValidatorHistoryPoint[], required
    - `epoch` integer, required — The epoch number.
    - `active_balance` string, bigint
    - `active_shares` string, bigint
    - `debonding_balance` string, bigint
    - `debonding_shares` string, bigint
    - `num_delegators` integer — The number of accounts that have delegated token to this account.

## Other responses

- `400` — A human-readable error message.
- `404` — An empty response indicating that the requested resource was not found.
- `500` — A human-readable error message.

---

[API](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1.md) · [All operations](https://skmtc.net/oasisprotocol/apis/oasis-nexus-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/oasisprotocol/oasis-nexus-api-v1/versions/a841981f8ee1/schema)