Sign in

v50

latestOpenAPI 3.0.0The Radix License, Version 1.0raw.githubusercontent.com2026-04-0736336265.6 KB
Extensions

Get entities by role requirement lookup

This endpoint is intended to query for entities that have ever used a given requirement (resource or non-fungible global ID) in their access rules (blueprint authentication templates, owner roles, or role assignments). This endpoint allows querying by multiple requirements. A maximum of 50 requirements can be queried. A maximum of 20 entities per requirement will be returned. To retrieve subsequent pages, use the returned cursor and call the /extensions/entities-by-role-requirement/page 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.
post/extensions/entities-by-role-requirement/lookup

Request body

Example request

{
  "requirements": [
    {
      "resource_address": "<sample-requirement-resource-address>",
      "non_fungible_id": "<sample-requirement-non-fungible-id>"
    }
  ]
}

Response

List of entities, per requested requirement, that have ever used the queried requirements in their access rules.