Skip to main content
GET
/
inspect-labelhash
/
{network_name}
/
{labelhash}
/
{parent_name}
curl --request GET \
  --url https://api.nameguard.io/inspect-labelhash/{network_name}/{labelhash}/{parent_name}

{
  "rating": 3,
  "risk_count": 2,
  "highest_risk": {
    "check": "confusables",
    "status": 3,
    "message": "<string>",
    "check_name": "<string>"
  },
  "name": "vitalìk.eth",
  "namehash": "0xd48fd5598e605861cbd8e45419b41b83739bff52eaef0e283181bbe0a43a5b32",
  "normalization": "normalized",
  "checks": [
    {
      "check": "confusables",
      "status": 3,
      "message": "<string>",
      "check_name": "<string>"
    }
  ],
  "labels": [
    {
      "rating": 3,
      "risk_count": 2,
      "highest_risk": {
        "check": "confusables",
        "status": 3,
        "message": "<string>",
        "check_name": "<string>"
      },
      "label": "vitalìk",
      "labelhash": "0x41459971a5b847d0eef67bc11e2845f1074a2aed1ac6a357378b18fba50816e4",
      "normalization": "normalized",
      "checks": [
        {
          "check": "confusables",
          "status": 3,
          "message": "<string>",
          "check_name": "<string>"
        }
      ],
      "graphemes": [
        {
          "rating": 3,
          "risk_count": 2,
          "highest_risk": {
            "check": "confusables",
            "status": 3,
            "message": "<string>",
            "check_name": "<string>"
          },
          "normalization": "normalized",
          "grapheme": "v",
          "grapheme_name": "Latin Small Letter V",
          "grapheme_type": "simple_letter",
          "grapheme_script": "Latin",
          "grapheme_description": "A-Z letter",
          "title": "<string>",
          "subtitle": "<string>"
        }
      ],
      "canonical_label": "vitalik",
      "title": "<string>",
      "subtitle": "<string>",
      "beautiful_label": "<string>"
    }
  ],
  "canonical_name": "vitalik.eth",
  "title": "<string>",
  "subtitle": "<string>",
  "beautiful_name": "<string>"
}
curl --request GET \
  --url https://api.nameguard.io/inspect-labelhash/{network_name}/{labelhash}/{parent_name}

Path Parameters

​
network_name
enum<string>
required
Available options:
mainnet,
sepolia
​
labelhash
string
required

Labelhash should be a decimal or a hex (prefixed with 0x) string.

Examples:

"0x3276e4878615389906712b876ce1455b8f5d1c5ea3ffcf7a705e0d32fafae9c5"

​
parent_name
string
required

Parent name of the labelhash (default empty).

Examples:

"eth"

Response

Successful Response

Full name analysis result with information about individual checks and labels.

​
rating
enum<integer>
required

The rating of a name/label/grapheme based on multiple conducted checks.

  • pass: All checks passed.
  • warn: At least one check failed with a WARN status but no check failed with an ALERT status.
  • alert: At least one check failed with an ALERT status.
Available options:
2,
3,
4
Examples:

3

​
risk_count
integer
required

The number of checks that have a status of alert or warn.

Examples:

2

​
highest_risk
object | null
required

The check considered to be the highest risk. If no check has a status of alert or warn, this field is null. The result of a conducted check.

​
name
string
required

The analyzed name. Can contain labelhashes when some labels are unknown.

Examples:

"vitalìk.eth"

"[af498306bb191650e8614d574b3687c104bc1cd7e07c522954326752c6882770].eth"

​
namehash
string
required

The namehash of the name in hex format prefixed with 0x.

Examples:

"0xd48fd5598e605861cbd8e45419b41b83739bff52eaef0e283181bbe0a43a5b32"

​
normalization
enum<string>
required

The ENSIP-15 normalization status of a name or label.

  • normalized: The name or label is normalized.
  • unnormalized: The name or label is not normalized.
  • unknown: The name or label is unknown because it cannot be looked up from its hash.
Available options:
normalized,
unnormalized,
unknown
​
checks
GenericCheckResult · object[]
required

A list of checks that were performed on the name.

​
labels
LabelGuardReport · object[]
required

The analyzed labels of the name.

​
canonical_name
string | null
required

The canonical form of the analyzed name.

  • null if the canonical form of any label is not known
  • can contain labelhashes when some labels are unknown
Examples:

"vitalik.eth"

​
title
string
required

A human-readable title based on the rating.

​
subtitle
string
required

A human-readable subtitle based on the rating.

​
beautiful_name
string | null
required

Beautified version of name.