Location

Get Non-Fungible Location

Returns location of a given non-fungible ID.

post

/state/non-fungible/location

Header parameters

api-keystringrequired

Body

at_ledger_statenullable 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_addressstringrequired

Bech32m-encoded human readable version of the address.

non_fungible_idsstring[]required

limited to max 100 items.

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://xrd-gateway.nownodes.io/state/non-fungible/location' \
  --header 'api-key: text' \
  --header 'Content-Type: application/json' \
  --data '{"resource_address":"<non-fungible-entity-address>","non_fungible_ids":["#1#"]}'

200

4XX

200

{
  "ledger_state": {
    "network": "mainnet",
    "state_version": 1,
    "proposer_round_timestamp": "text",
    "epoch": 1,
    "round": 1
  },
  "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": true,
      "last_updated_at_state_version": 1
    }
  ]
}

Non-Fungible ID Location