---
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`

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

---

[API](https://skmtc.net/radixdlt/apis/radix-gateway-api-babylon.md) · [All operations](https://skmtc.net/radixdlt/apis/radix-gateway-api-babylon/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/radixdlt/radix-gateway-api-babylon/revisions/153aecf74342/schema)