Ids

Get page of Non-Fungible Ids in Resource Collection

Returns the non-fungible IDs of a given non-fungible resource. Returned response is in a paginated format, ordered by their first appearance on the ledger.

POSThttps://xrd-gateway.nownodes.io/state/non-fungible/ids

Header parameters

Body

application/json

at_ledger_statenullable LedgerStateSelector (object)

Optional. This allows for a request to be made against a historic state. If a constraint is specified, the Gateway will resolve the request against the ledger state at that time. If not specified, requests will be made with respect to the top of the committed ledger.

cursornullable string

This cursor allows forward pagination, by providing the cursor from the previous request.

limit_per_pagenullable integer

The page size requested.

resource_address*Address (string)

Bech32m-encoded human readable version of the address.

Response

2004XX

Non-Fungible IDs (paginated)

Body

application/json

ledger_state*LedgerState (object)

The ledger state against which the response was generated. Can be used to detect if the Network Gateway is returning up-to-date information.

resource_address*Address (string)

Bech32m-encoded human readable version of the address.

non_fungible_ids*NonFungibleIdsCollection (all of)

Non-fungible resource IDs collection.

Request

JavaScriptCurlPython

const response = await fetch('https://xrd-gateway.nownodes.io/state/non-fungible/ids', {
    method: 'POST',
    headers: {
      "api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "resource_address": "<non-fungible-entity-address>"
    }),
});
const data = await response.json();

Response

2004XX

{
  "ledger_state": {
    "network": "mainnet",
    "state_version": 0,
    "proposer_round_timestamp": "text",
    "epoch": 0,
    "round": 0
  },
  "resource_address": "text",
  "non_fungible_ids": {
    "total_count": 0,
    "next_cursor": "text",
    "items": [
      "text"
    ]
  }
}