Get the NFT ID of an existing NFT through its External Reference

Returns the NFT ID for a given external reference.

await api.query.getNftId(external_reference);

tip

If you're checking the ID for a newly minted NFT, allow time for consensus to be achieved on the minted NFT.

Example

const AvnApi = require("avn-api");
const GATEWAY = "<endpoint_url>"; //Replace the endpoint_url with the url received from Aventus.
const api = new AvnApi(GATEWAY);

const externalRef = "https://5DA/gxV"; //replace with the external ref set when minting the NFT.

async function main() {
    await api.init();

    const result = await api.query.getNftId(external_reference);
    // Returns a request id
    console.log(result);
}

(async () => {
    await main();
})();

Example Output

0x1068fa5b1f3e033d7e802a2d3f355a0b96b07f367c69ba1aa2ea58ee61af82ce

JSON-RPC

REQUEST POST https://AVN-API-URL/query

HEADERS Content-Type: application/json Authorization': bearer <awtToken>

REQUEST PARAMS externalRef [required] - a unique string representing the NFT's external reference

Example

## JSON-RPC over HTTPS POST
curl https://AVN-API-URL/query \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: bearer <awtToken>" \
    -d '{"jsonrpc":"2.0", "method":"getNftId", "params":{"externalRef":"my_unique_nft_2022-01-17T12:15:31Z"}, "id":1}'

note

result - hex string value representing the NFT ID

Example Result

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x4184aa1d0e5a1a44d36d92b02ad07ab4285a43086f538a7e5b7d5cbd858e0e71"
}

Production Example

Multiple NFTs have been minted on the AVN and HERE is a link to the AVN Explorer that provides more detail on the minted NFT. Click on the Advanced tab on the page to view more details on the transaction.