Skip to main content

/v1/names/{name} REST API Endpoint

Retrieves details of a given name including the `address`, `status` and last transaction id - `last_txid`.

Updated on
Oct 4, 2023

/v1/names/{name} REST API Endpoint

Path Parameters

name
string
REQUIRED
fully-qualified name (e.g., muneeb.id)

Returns

object
object
Get name details
address
string
The address associated with the name. It represents the owner or holder of the name in the blockchain system.
blockchain
string
The blockchain network on which the name is registered. It indicates the specific blockchain platform where the name exists.
expire_block
integer
The block number at which the name will expire if not renewed. It represents the point in the blockchain where the name registration will no longer be valid.
grace_period
boolean
A flag indicating whether the name is currently in the grace period. If true, it means the name registration has expired but can still be renewed during this period.
last_txid
string
The transaction ID of the last transaction associated with the name. It provides a unique identifier for the most recent transaction involving the name.
renewal_deadline
integer
The block number representing the deadline by which the name must be renewed. If the name is not renewed before this block, it will no longer be possible to renew it.
resolver
string
The resolver associated with the name. It specifies the address or location of the resolver contract responsible for handling the resolution of the name to associated data.
status
string
The current status of the name. It provides information about the state of the name registration, such as 'registered,' 'expired,' or 'renewed.'
zonefile
string
The zone file associated with the name. It contains information about the name and its associated records, such as DNS information.
zonefile_hash
string
The hash of the zone file associated with the name. It provides a unique identifier for the zone file and can be used to verify the integrity of the zone file data.
Request
1
curl -X 'GET' \
2
'https://docs-demo.stacks-mainnet.quiknode.pro/v1/names/muneeb.id' \
3
-H 'Content-Type: application/json'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free