---
title: "Changes to Retrieve the Validator states for a cluster"
method: GET
path: "/v1/state/{lockHash}"
---

# Changes to Retrieve the Validator states for a cluster

`GET /v1/state/{lockHash}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 20 revisions.

- **2026-10-28** `c545dd14c211`: 3 info
- **2026-10-22** `ffbd09536a1a`: 1 info
- **2026-10-17** `7aa38d7112df`: 7 breaking
- **2026-03-09** `6393352e05fd`: 1 info
- **2025-09-16** `ab6da486f56c`: 2 info
- **2025-04-23** `02516e7f042a`: 2 info
- **2024-12-05** `3896d3513a5d`: 1 info
- **2024-07-25** `52d1f82e219e`: 1 info

## Changes

- **2026-10-28** `c545dd14c211`: 3 info
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `404`
  - added the media type `application/json` for the response with the status `500`
- **2026-10-22** `ffbd09536a1a`: 1 info
  - added the required property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/credentials_conflict` to the response with the `200` status
- **2026-10-17** `7aa38d7112df`: 7 breaking
  - the response property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/balance` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/effective_balance` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/index` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/is_not_within_committee` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/pending_partial_deposits` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/pending_partial_withdrawals` became nullable for the status `200`
  - the response property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/withdrawal_credentials` became nullable for the status `200`
- **2026-03-09** `6393352e05fd`: 1 info
  - added the required property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/is_not_within_committee` to the response with the `200` status
- **2025-09-16** `ab6da486f56c`: 2 info
  - added the required property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/pending_partial_deposits` to the response with the `200` status
  - added the required property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/pending_partial_withdrawals` to the response with the `200` status
- **2025-04-23** `02516e7f042a`: 2 info
  - added the required property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/effective_balance` to the response with the `200` status
  - added the required property `anyOf[#/components/schemas/DistributedValidatorStateResponse]/withdrawal_credentials` to the response with the `200` status
- **2024-12-05** `3896d3513a5d`: 1 info
  - api operation id `StateController_getDistributedValidatorStatesByLockHash` removed and replaced with `StateController_getDistributedValidatorStatesByLockHash_v1`
- **2024-07-25** `52d1f82e219e`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/obol/apis/obol-api/docs/v1/state/:lockHash/get.md) - [API](https://skmtc.dev/obol/apis/obol-api.md) - [Page](https://skmtc.dev/obol/apis/obol-api/changes/v1/state/:lockHash/get)