---
title: "Get entities by role requirement page"
method: POST
path: "/extensions/entities-by-role-requirement/page"
tags: ["Extensions"]
---

# Get entities by role requirement page

`POST /extensions/entities-by-role-requirement/page`

## Request

- Base URL: `https://mainnet.radixdlt.com`
- URL: `https://mainnet.radixdlt.com/extensions/entities-by-role-requirement/page`
- Auth: none declared

Paginated endpoint returns a page of global entities that have ever used the provided requirement (such as a resource or non-fungible global ID) in their access rules (blueprint authentication templates, owner roles, or role assignments).
This endpoint allows querying by a single requirement. By default it returns up to 100 entries are returned per response. This limit can be increased to a maximum of 1000 entries per page using the `limit_per_page` parameter.
To retrieve subsequent pages, use the returned cursor and call the `/extensions/entities-by-role-requirement/page` endpoint.

To lookup multiple requirements, please call the `/extensions/entities-by-role-requirement/lookup` endpoint.

Behaviour:
- Entities are returned in ascending order by the state version in which the requirement was first observed on the ledger.
- It may include entities that no longer use the requirement as part of an access rule.
- If no entities are found, an empty list will be returned.

## Request body

- EntitiesByRoleRequirementPageRequest
  - `cursor` string, nullable: This cursor allows forward pagination, by providing the cursor from the previous request.
  - `limit_per_page` integer, nullable: The page size requested.
  - `resource_address` string, required: Bech32m-encoded human readable version of the address.
  - `non_fungible_id` string: String-encoded non-fungible ID.

## Response `200`

List of entities that have ever used the queried requirement in their access rules.

- EntitiesByRoleRequirementPageResponse
  - `total_count` integer, nullable: Total number of items in underlying collection, fragment of which is available in `items` collection.
  - `next_cursor` string, nullable: If specified, contains a cursor to query next page of the `items` collection.
  - `entities` EntitiesByRoleRequirementItem[], required
    - `entity_address` string, required: Bech32m-encoded human readable version of the address.
    - `first_seen_state_version` integer, required

## Other responses

- `4XX`: Client-originated request error

## Changes

- **2025-03-06** `428c7819d589`: 1 info
  - endpoint added
- **2025-03-03** `7147af27c92d`: 1 breaking
  - api path removed without deprecation
- **2025-02-05** `02d44e26fa1e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/radixdlt/apis/radix-gateway-api-babylon/changes/extensions/entities-by-role-requirement/page/post.md)

---

[API](https://skmtc.dev/radixdlt/apis/radix-gateway-api-babylon.md) - [All operations](https://skmtc.dev/radixdlt/apis/radix-gateway-api-babylon/llms.txt) - [OpenAPI document](https://skmtc.dev/radixdlt/apis/radix-gateway-api-babylon/revisions/153aecf74342?raw)