Grails API Documentation

GET /api/v1/names/:name/metadata

Fetch fresh ENS text records for a name directly from The Graph. Unlike the main name endpoint which uses cached metadata, this always queries The Graph for the latest records. Database sync happens asynchronously.

Authentication: None

Cache: None

Path Parameters

Parameter	Type	Required	Description
`name`	string	Yes	ENS name (e.g. `example.eth`)

Sample Request


curl https://api.grails.app/api/v1/names/example.eth/metadata

Response


// 200 OK
{
  "success": true,
  "data": {
    "name": "brantly.eth",
    "metadata": {
      "avatar": "https://euc.li/brantly.eth",
      "header": "https://euc.li/brantly.eth/h",
      "description": "Catholic, husband, father | building ...",
      "url": "https://ethid.org/",
      "com.twitter": "brantlymillegan",
      "com.github": "brantlymillegan",
      "org.telegram": "brantlymillegan",
      "location": "USA",
      "email": "me@brantly.xyz",
      "status": "building an onchain social graph for ethereum accounts",
      "chains": [
        { "coinType": 0, "chainName": "Bitcoin", "address": "bc1q..." },
        { "coinType": 60, "chainName": "Ethereum", "address": "0x9831..." }
      ]
    },
    "source": "graph"
  },
  "meta": {
    "timestamp": "2026-04-09T12:00:00.000Z",
    "version": "1.0.0"
  }
}

Error Responses

Status	Code	Description
404	`NAME_NOT_FOUND`	ENS name not found in database