Get name details

Retrieves details of a given name including the address, status and last transaction ID.

GET
/v1/names/{name}

Path Parameters

namestring

fully-qualified name

Query Parameters

unanchored?boolean

Include data from unanchored (i.e. unconfirmed) microblocks

Defaultfalse

Response Body

Get name details

TypeScript Definitions

Use the response body type in TypeScript.

addressstring
blockchainstring
expire_block?integer
grace_period?integer
last_txidstring
resolver?string
statusstring
zonefile?string
zonefile_hashstring

Default Response

TypeScript Definitions

Use the response body type in TypeScript.

errorstring
message?string
[key: string]any
curl -X GET "https://api.hiro.so//v1/names/muneeb.id?unanchored=true"
fetch("https://api.hiro.so//v1/names/muneeb.id?unanchored=true")
package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://api.hiro.so//v1/names/muneeb.id?unanchored=true"

  req, _ := http.NewRequest("GET", url, nil)
  
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  body, _ := ioutil.ReadAll(res.Body)

  fmt.Println(res)
  fmt.Println(string(body))
}
import requests

url = "https://api.hiro.so//v1/names/muneeb.id?unanchored=true"

response = requests.request("GET", url)

print(response.text)
{
  "address": "1J3PUxY5uDShUnHRrMyU6yKtoHEUPhKULs",
  "blockchain": "stacks",
  "expire_block": 599266,
  "grace_period": false,
  "last_txid": "1edfa419f7b83f33e00830bc9409210da6c6d1db60f99eda10c835aa339cad6b",
  "renewal_deadline": 604266,
  "resolver": null,
  "status": "registered",
  "zonefile": "$ORIGIN muneeb.id\n$TTL 3600\n_http._tcp IN URI 10 1 \"https://gaia.blockstack.org/hub/1J3PUxY5uDShUnHRrMyU6yKtoHEUPhKULs/0/profile.json\"\n",
  "zonefile_hash": "37aecf837c6ae9bdc9dbd98a268f263dacd00361"
}
{
  "error": "string",
  "message": "string"
}