---
title: "Retrieve a list of Distributed Validator Cluster Lock Objects"
method: GET
path: "/v1/lock/search/{network}"
tags: ["Cluster Lock"]
---

# Retrieve a list of Distributed Validator Cluster Lock Objects

`GET /v1/lock/search/{network}`

This endpoint is used to search for Cluster Lock Objects that match a substring of their `lock_hash`.

## Path parameters

- `network` string, required

## Query parameters

- `partialLockHash` string, required
- `partialClusterName` string, required
- `page` integer, required
- `limit` integer, required

## Response `200`

A list of Distributed Validator Clusters which the lock hash matches.

- ClusterLockPagedResponse
  - `cluster_locks` string[], required
  - `total_active_stake_eth` number, nullable — Null when the operator has locks but no recent metrics snapshot is available.
  - `total_active_stake_usd` number, nullable — Null when the operator has locks but no recent metrics snapshot is available.
  - `unique_validators_count` number, nullable — Null when the operator has locks but no recent metrics snapshot is available.
  - `total_count` number, required
  - `total_pages` number, 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)