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

# Retrieve a Distributed Validator Cluster Lock Object

`GET /lock/{lockHash}`

This endpoint is used to retrieve a cluster lock object.

## Path parameters

- `lockHash` string, required

## Query parameters

- `validators` boolean

## Response `200`

The cluster lock object

- union
  - 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
  - ClusterLockShellResponse
    - `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
    - `signature_aggregate` string, required
    - `lock_hash` string, required
    - `node_signatures` string[], required
    - `validator_count` number, required — Number of distributed validators in this cluster lock.

## 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)