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

# Submit partial fee recipient registrations

`POST /v1/fee_recipient/partial/{lockHash}/{shareIdx}`

Stores partial BLS-signed builder registration messages for a given cluster operator. Partials are grouped into builder registrations by message content (fee_recipient, gas_limit, timestamp). The timestamp must be greater than or equal to the highest timestamp any operator has submitted for each pubkey. Equal timestamps are allowed so operators can join an existing registration group.

## Path parameters

- `lockHash` string, required
- `shareIdx` number, required

## Request body

- FeeRecipientDto
  - `partial_registrations` PartialRegistrationDto[], required
    - `message` RegistrationMessageDto, required
      - `fee_recipient` string, required
      - `gas_limit` string, required
      - `timestamp` string, required
      - `pubkey` string, required
    - `signature` string, required

## Response `201`

Partial registrations saved successfully.

## Other responses

- `400` — Invalid request body, signature verification failed, invalid share index, or duplicate pubkey in request.
- `404` — Lock 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)