Grails API Documentation

GET /api/v1/ens-roles/users/:address/manageable-names

Get all ENS names that an address can manage (update records for), with pagination. Results are enriched with full search result data and include the user’s role (owner, manager, or both).

Authentication: Optional (enriches results with user-specific data)

Cache: 15s

Path Parameters

Parameter	Type	Required	Description
`address`	string	Yes	Ethereum address (`0x` + 40 hex)

Query Parameters

Parameter	Type	Default	Description
`page`	number	`1`	Page number (min 1)
`limit`	number	`20`	Results per page (1–100)

Sample Request


curl "https://api.grails.app/api/v1/ens-roles/users/0x983110309620d911731ac0932219af06091b6744/manageable-names?page=1&limit=10"

Response


// 200 OK
{
  "success": true,
  "data": {
    "address": "0x983110309620d911731ac0932219af06091b6744",
    "names": [
      {
        "name": "example.eth",
        "role": "both",
        // ... standard search result fields
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 10,
      "total": 15,
      "totalPages": 2,
      "hasNext": true,
      "hasPrev": false
    }
  },
  "meta": {
    "timestamp": "2026-04-08T00:00:00.000Z",
    "version": "1.0.0"
  }
}