---
title: "Fetch partial fee recipient registrations"
method: POST
path: "/v1/fee_recipient/{lockHash}"
tags: ["Fee Recipient"]
---

# Fetch partial fee recipient registrations

`POST /v1/fee_recipient/{lockHash}`

Returns builder registration status for validators in a cluster. For each validator, returns at most two registrations: the latest one that reached quorum (quorum: true) and the latest one still collecting signatures (quorum: false). Validators with no registration data are omitted. Optionally pass an array of pubkeys in the request body to filter results.

## Path parameters

- `lockHash` string, required

## Request body

- FetchQueryDto
  - `pubkeys` string[] — Optional list of validator pubkeys to filter by. If omitted or empty, returns all validators with registrations.

## Response `200`

Per validator: at most 2 builder registrations (latest with quorum: true, latest with quorum: false). Each registration includes the signed message, partial signatures, and a quorum boolean. Pubkeys returned without 0x prefix.

## Other responses

- `404` — Lock not found or no partial registrations 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)