Skip to content
ENSNode

Find Domains

List domains matching a name prefix with ordering and registration metadata.
Run in ENSAdmin 
query FindDomains(
  $name: String!
  $order: DomainsOrderInput
) {
  domains(
    where: { name: $name }
    order: $order
    first: 20
  ) {
    edges {
      node {
        __typename
        id
        label { interpreted hash }
        name

        registration { expiry event { timestamp } }
      }
    }
  }
}
{
  "name": "test-na",
  "order": {
    "by": "NAME",
    "dir": "DESC"
  }
}
{
  "data": {
    "domains": {
      "edges": [
        {
          "node": {
            "__typename": "ENSv1Domain",
            "id": "99911155111-0x00000000000c2e074ec69a0dfb2997ba6c7d2e1e-0xfef70852da2a0a32225b513391c3dcf0f3b5cccf343bde23fa1f8464cbe5a2c2",
            "label": {
              "interpreted": "test-names",
              "hash": "0xf8899b8332fc898c86bfe588219b29362bb1335ce9738d7a34508d817ab31133"
            },
            "registration": {
              "expiry": "1751190612",
              "event": {
                "timestamp": "1747216212"
              }
            },
            "name": "test-names.eth"
          }
        },
        {
          "node": {
            "__typename": "ENSv2Domain",
            "id": "99911155111-0x31a2bb5d933557cce1b3129993193896d074db92-14580361689616036777059995592070852680799975896349261373821065539059361775616",
            "label": {
              "interpreted": "test-namers",
              "hash": "0x203c3138956e0cab1c57684ba6b9cf550db4e624055a6b0e30caee16609eac9d"
            },
            "registration": {
              "expiry": "1793279532",
              "event": {
                "timestamp": "1777667178"
              }
            },
            "name": "test-namers.eth"
          }
        },
        {
          "node": {
            "__typename": "ENSv1Domain",
            "id": "99911155111-0x00000000000c2e074ec69a0dfb2997ba6c7d2e1e-0x598e24a25300d326443e87af828c71764964f2e318850c2a517e9dc0115b43c9",
            "label": {
              "interpreted": "test-namers",
              "hash": "0x203c3138956e0cab1c57684ba6b9cf550db4e624055a6b0e30caee16609eac9d"
            },
            "registration": {
              "expiry": "1793279532",
              "event": {
                "timestamp": "1761743532"
              }
            },
            "name": "test-namers.eth"
          }
        },
        {
          "node": {
            "__typename": "ENSv2Domain",
            "id": "99911155111-0x31a2bb5d933557cce1b3129993193896d074db92-18650549467948381174706470291653511222307197070371999253038345217664991887360",
            "label": {
              "interpreted": "test-name",
              "hash": "0x293bd640008c5863fbe17a08ae5df5b2484357f5dc95e0fdd089f85e7edbfe5a"
            },
            "registration": {
              "expiry": "1785702972",
              "event": {
                "timestamp": "1777667203"
              }
            },
            "name": "test-name.eth"
          }
        },
        {
          "node": {
            "__typename": "ENSv1Domain",
            "id": "99911155111-0x00000000000c2e074ec69a0dfb2997ba6c7d2e1e-0x527f8d39fa87ac23b6431913e880aa29425dc0450651a22d9a3b881a29661a0b",
            "label": {
              "interpreted": "test-name",
              "hash": "0x293bd640008c5863fbe17a08ae5df5b2484357f5dc95e0fdd089f85e7edbfe5a"
            },
            "registration": {
              "expiry": "1785702972",
              "event": {
                "timestamp": "1754166972"
              }
            },
            "name": "test-name.eth"
          }
        }
      ]
    }
  }
}
# POST JSON to your ENSNode Omnigraph endpoint (same path enssdk uses).
curl -sS -X POST "https://api.v2-sepolia.ensnode.io/api/omnigraph" \
  -H "Content-Type: application/json" \
  -d @- <<'EOF'
{
  "query": "query FindDomains( $name: String! $order: DomainsOrderInput ) { domains( where: { name: $name } order: $order first: 20 ) { edges { node { __typename id label { interpreted hash } name registration { expiry event { timestamp } } } } } }",
  "variables": {
    "name": "test-na",
    "order": {
      "by": "NAME",
      "dir": "DESC"
    }
  }
}
EOF
ENS Omnigraph GraphQL 
query FindDomains(
  $name: String!
  $order: DomainsOrderInput
) {
  domains(
    where: { name: $name }
    order: $order
    first: 20
  ) {
    edges {
      node {
        __typename
        id
        label { interpreted hash }
        name


        registration { expiry event { timestamp } }
      }
    }
  }
}

Payload and transport examples

{
  "name": "test-na",
  "order": {
    "by": "NAME",
    "dir": "DESC"
  }
}

Response is an illustrative snapshot; live data depends on your ENSNode instance. The curl tab shows a POST to https://api.v2-sepolia.ensnode.io/api/omnigraph

Back to Examples