Skip to main content
GET
/
api
/
v1
/
subnames
/
{fullSubname}
Get Subname by Full Name
curl --request GET \
  --url https://offchain-manager.namespace.ninja/api/v1/subnames/{fullSubname}
{
  "id": "123",
  "fullName": "alice.oppunk.eth",
  "parentName": "oppunk.eth",
  "label": "alice",
  "texts": {
    "email": "[email protected]"
  },
  "addresses": {
    "ETH": "0x1234...abcd"
  },
  "metadata": {
    "role": "admin"
  },
  "contenthash": "ipfs://Qm...",
  "namehash": "0xabc123..."
}

Path Parameters

​
fullSubname
string
required

The full subname to retrieve (e.g., alice.oppunk.eth)

Example:

"alice.oppunk.eth"

Response

Subname found

​
id
string
required

Unique identifier of the subname

Example:

"123"

​
fullName
string
required

Full name of the subname (e.g., alice.oppunk.eth)

Example:

"alice.oppunk.eth"

​
parentName
string
required

Parent name (e.g., oppunk.eth)

Example:

"oppunk.eth"

​
label
string
required

Label of the subname (e.g., alice)

Example:

"alice"

​
texts
object
required

Text records associated with the subname

Example:
{ "email": "[email protected]" }
​
addresses
object
required

Address records associated with the subname

Example:
{ "ETH": "0x1234...abcd" }
​
metadata
object
required

Metadata associated with the subname

Example:
{ "role": "admin" }
​
namehash
string
required

Namehash of the subname

Example:

"0xabc123..."

​
contenthash
string

Content hash of the subname

Example:

"ipfs://Qm..."