Get names owned by address

Retrieves the list of names owned by a specific address.

GET
/v1/addresses/{blockchain}/{address}

Path Parameters

blockchainstring

the layer-1 blockchain for the address

addressstring

the address to lookup

Query Parameters

unanchored?boolean

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

Defaultfalse

Response Body

Retrieves a list of names owned by the address provided.

TypeScript Definitions

Use the response body type in TypeScript.

namesarray<string>

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/addresses/stacks/SP2J6ZY48GV1EZ5V2V5RB9MP66SW86PYKKNRV9EJ7?unanchored=true"
fetch("https://api.hiro.so//v1/addresses/stacks/SP2J6ZY48GV1EZ5V2V5RB9MP66SW86PYKKNRV9EJ7?unanchored=true")
package main

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

func main() {
  url := "https://api.hiro.so//v1/addresses/stacks/SP2J6ZY48GV1EZ5V2V5RB9MP66SW86PYKKNRV9EJ7?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/addresses/stacks/SP2J6ZY48GV1EZ5V2V5RB9MP66SW86PYKKNRV9EJ7?unanchored=true"

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

print(response.text)
{
  "names": [
    "muneeb.id"
  ]
}
{
  "error": "string",
  "message": "string"
}