Skip to main content

/api/v1/tokens/{tokenId}/nfts REST API Endpoint

Returns a list of non-fungible tokens.

Updated on
Aug 23, 2024

/api/v1/tokens/{tokenId}/nfts REST API Endpoint

Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.

Path Parameters

tokenId
string
REQUIRED
The network entity ID in the format of shard.realm.num

Query Parameters

account.id
string
The ID of the account to return information for
limit
integer
The maximum number of items to return
order
string
The order in which items are listed (asc or desc)
serialnumber
string
The nft serial number (64 bit type). Requires a tokenId value also be populated

Returns

nfts
array
An array of objects, each representing an NFT on the Hedera network
account_id
string
The ID of the account that owns the NFT
created_timestamp
string
The timestamp when the NFT was created
delegating_spender
string
The ID of the account that has been delegated spending rights for the NFT
deleted
boolean
A boolean indicating whether the NFT has been deleted
metadata
string
The metadata associated with the NFT, encoded in Base64
modified_timestamp
string
The timestamp when the NFT was last modified
serial_number
integer
The unique serial number of the NFT
spender_id
string
The ID of the account that has been approved to spend the NFT
token_id
string
The ID of the token to which the NFT belongs
links
object
An object containing pagination links
next
string
The URL for the next set of results if available
Request
1
curl 'https://docs-demo.hedera-mainnet.quiknode.pro/api/v1/tokens/{tokenId}/nfts'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free