---
title: "Retrieve a Distributed Validator Cluster proposal"
method: GET
path: "/v1/definition/{configHash}"
tags: ["Cluster Definition"]
---

# Retrieve a Distributed Validator Cluster proposal

`GET /v1/definition/{configHash}`

This endpoint allows a charon client or launchpad interface to retrieve the terms of a proposed DKG. Once all operators listed in the DKG have submitted signed approvals to the terms, this object will be ready for a cluster of operators to use as part of a DKG ceremony. If the objects in the `operators` array are not fully populated, these operators need to use the [PUT request](#/Distributed%20Validators/DefinitionController_updateClusterDefinition) to upload their charon client's public key and a signature from their address to indicate their acceptance of the terms.

## Path parameters

- `configHash` string, required

## Response `200`

The cluster object

- ClusterDefinitionResponse
  - `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

## Other responses

- `404` — Cluster definition 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)