Get namespace names

Retrieves a list of names within a given namespace.

GET
/v1/namespaces/{tld}/names

Path Parameters

tldstring

the namespace to fetch names from.

Query Parameters

page?number

namespace values are defaulted to page 1 with 100 results. You can query specific page results by using the 'page' query parameter.

unanchored?boolean

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

Defaultfalse

Response Body

Fetch a list of names from the namespace.

TypeScript Definitions

Use the response body type in TypeScript.

response?BnsGetAllNamespacesNamesResponse

Fetch a list of names from the namespace.

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/namespaces/id/names?page=22&unanchored=true"
fetch("https://api.hiro.so//v1/namespaces/id/names?page=22&unanchored=true")
package main

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

func main() {
  url := "https://api.hiro.so//v1/namespaces/id/names?page=22&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/namespaces/id/names?page=22&unanchored=true"

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

print(response.text)
[
  "aldenquimby.id",
  "aldeoryn.id",
  "alderete.id",
  "aldert.id",
  "aldi.id",
  "aldighieri.id"
]
{
  "error": "string",
  "message": "string"
}