---
title: "Retrieve a Distributed Validator Cluster Lock Object"
method: GET
path: "/v1/lock/configHash/{configHash}"
tags: ["Cluster Lock"]
---

# Retrieve a Distributed Validator Cluster Lock Object

`GET /v1/lock/configHash/{configHash}`

This endpoint is used to retrieve a cluster lock object by the hash of the configuration used to create it.

## Path parameters

- `configHash` string, required

## Response `200`

The cluster lock object

- ClusterLockResponse
  - `cluster_definition` ClusterDefinitionResponse, required
    - `name` string, required
    - `uuid` string, required
    - `creator` Creator, required
    - `version` string, required
    - `num_validators` number, required
    - `threshold` number, required
    - `dkg_algorithm` string, required
    - `fork_version` string, required
    - `config_hash` string, required — config_hash is a 32 bytes SSZ hash of cluster config.
    - `timestamp` string, required
    - `validators` Validator[], required
    - `deposit_amounts` string[], required — Partial depoists.
    - `definition_hash` string, required — definition_hash is a 32 bytes SSZ hash of cluster config.
    - `fee_recipient_address` string, required — Ethereum address to receive transaction fees.
    - `withdrawal_address` string, required — Ethereum address to receive staked ether.
    - `operators` Operator[], required
    - `consensus_protocol` string, required
    - `target_gas_limit` number, required
    - `compounding` boolean, required
  - `distributed_validators` DistributedValidator[], required
  - `signature_aggregate` string, required
  - `lock_hash` string, required
  - `node_signatures` string[], required

## Other responses

- `404` — Cluster not found
- `500` — An unknown error occurred

---

[API](https://skmtc.net/obol/apis/obol-api.md) · [All operations](https://skmtc.net/obol/apis/obol-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/obol/obol-api/revisions/707a88e0b355/schema)