Extensions

Get entities by role requirement lookup

Changed on

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

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

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.

Changes