Location

Get Non-Fungible Location

Returns location of a given non-fungible ID.

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

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.

resource_address*Address (string)

Bech32m-encoded human readable version of the address.

non_fungible_ids*array of NonFungibleId (string)

limited to max 100 items.

Response

2004XX

Non-Fungible ID Location

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*array of StateNonFungibleLocationResponseItem (object)

Request

JavaScriptCurlPython

const response = await fetch('https://xrd-gateway.nownodes.io/state/non-fungible/location', {
    method: 'POST',
    headers: {
      "api-key": "text",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "resource_address": "<non-fungible-entity-address>",
      "non_fungible_ids": [
        "#1#"
      ]
    }),
});
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": [
    {
      "non_fungible_id": "text",
      "owning_vault_address": "text",
      "owning_vault_parent_ancestor_address": "text",
      "owning_vault_global_ancestor_address": "text",
      "is_burned": false,
      "last_updated_at_state_version": 0
    }
  ]
}