Skip to content

Find Domains

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-name",
  "order": {
    "by": "NAME",
    "dir": "DESC"
  }
}
{
  "data": {
    "domains": {
      "edges": [
        {
          "node": {
            "__typename": "ENSv2Domain",
            "id": "eip155:11155111/erc1155:0x796fff2e907449be8d5921bcc215b1b76d89d080/18650549467948381174706470291653511222307197070371999253038345217664991887360",
            "label": {
              "interpreted": "test-name",
              "hash": "0x293bd640008c5863fbe17a08ae5df5b2484357f5dc95e0fdd089f85e7edbfe5a"
            },
            "registration": {
              "expiry": "1778940707",
              "event": {
                "timestamp": "1776435108"
              }
            },
            "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-name",
    "order": {
      "by": "NAME",
      "dir": "DESC"
    }
  }
}
EOF
ENS Omnigraph GraphQL
query.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

variables.json
{
"name": "test-name",
"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