---
title: "Retrieve locked beneficiary entities"
method: GET
path: "/beneficiaries/{beneficiaryId}/locks"
tags: ["Beneficiaries"]
---

# Retrieve locked beneficiary entities

`GET /beneficiaries/{beneficiaryId}/locks`

Fetch references of the entities (payment, rule) that have caused the beneficiary to be locked

## Path parameters

- `beneficiaryId` string, required

## Query parameters

- `page` integer — Page to fetch (0 indexed)
- `size` integer — Size of Page to fetch

## Response `200`

OK

- AccountBeneficiaryLockPageResponse
  - `content` AccountBeneficiaryLockResponse[] — List of responses on the current page
    - `ownerId` string — Reference for the entity owning the lock.
    - `ownerType` 'RULE' | 'PAYMENT' — Entity type owning the lock.
  - `size` integer — Page size
  - `totalSize` integer — Total count
  - `page` integer — Current page number, 0 based; i.e first-page = 0, second-page = 1
  - `totalPages` integer — Total pages

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/revisions/cbd52524c8ef/schema)
