Get the details about a Batch-NFT using it's ID.

Returns the listing details of a Batch-NFT.

await api.query.getBatchInfo(BATCH_ID);

tip

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

You can get the VL_GATEWAY_URL here.

Example

const { AvnApi, SetupMode, SigningMode } = require("avn-api");
const VL_GATEWAY_URL = "https://gateway.testnet.voucherledger.com";

const singleUserOptions = {
	suri: "0x5392ca60a61aea99fce14358798de93c1bc11c3696a905718738c71fae539c24", // this is from the generated example account
	setupMode: SetupMode.SingleUser,
	signingMode: SigningMode.SuriBased,
};

const avnSdk = new AvnApi(VL_GATEWAY_URL, singleUserOptions);

//replace with the external ref set when minting the NFT.
const BATCH_ID = "0xa6a...ae539";

async function main() {
	await avnSdk.init();
	const api = await avnSdk.apis();

	let request_id = await api.query.getBatchInfo(BATCH_ID);
	console.log(request_id);
}

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

Example Result

getNftListingStatus {
  ownerAddress: '5EYzWhGxbogEfwNKL52ZRDCgBxu4t8oWDFAsXXVYvH6dMQTo',
  nonce: 0,
  infoId: 7696,
  uniqueExternalRef: '0x3545...6516e7451',
  royalties: []
}

JSON-RPC

REQUEST
POST https://VL_GATEWAY_URL/query

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

REQUEST PARAMS

• BATCH_ID [required] - a unique string representing the NFT's ID.

JSON-RPC Example

curl https://VL_GATEWAY_URL/query \
    -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: bearer <awtToken>" \
    -d '{"jsonrpc":"2.0", "method":"getBatchInfo", "params":{"externalRef":"my_unique_nft_2022-01-17T12:15:31Z"}, "id":1}'

note

result - hex string value representing the NFT ID.

JSON-RPC Output

{
	"jsonrpc": "2.0",
	"id": 1,
	"result": getNftListingStatus {
  ownerAddress: '5EYzWhGxbogEfwNKL52ZRDCgBxu4t8oWDFAsXXVYvH6dMQTo',
  nonce: 0,
  infoId: 7696,
  uniqueExternalRef: '0x3545...6516e7451',
  royalties: []
}
}

---