indexer.getNamesForAddress
Lists the names an address owns, manages, holds roles on, resolves to, or used to own. Options, result, errors and examples for indexer.getNamesForAddress.
Lists the names an address owns, manages, holds roles on, resolves to, or used to own.
When to use
Use to show an account's names, e.g. a "my names" page or a name picker.
Details
relationdefaults toany: owner, manager and role holder.resolvesTo(withcoin) andformerOwnerare listed on their own.- Lists every namespace the indexer serves unless
namespaceis set. - Pages hold up to
limitnames (default 50, at most 200); passcursorfor the next page, or usepaginate.
Signature
function getNamesForAddress(
client: Like,
options: getNamesForAddress.Options,
): Promise<getNamesForAddress.ReturnType>Call it as ens.indexer.getNamesForAddress(options) on a client, or Actions.indexer.getNamesForAddress(client, options).
indexer.getNamesForAddress.request(options) builds a deferred read for Actions.batch. See Look up many at once.
In React, use useNamesForAddress.
Parameters
| Option | Type | Default | Description |
|---|---|---|---|
limit | number | Rows per page, 1–200. @default 50 | |
cursor | string | The previous page's cursor. | |
includeTotal | boolean | Count every row (totalCount); slower. | |
namespace | Namespace | Every namespace the indexer serves when omitted. | |
relation | Relation | "any" | readonly Relation[] | Relations to list; any is owner, manager and role holder. resolvesTo and formerOwner stand alone. @default "any" | |
authority | Authority | readonly Authority[] | ||
migrated | boolean | Only names migrated to ENSv2 (or only not migrated). | |
expiresAfter | bigint | Date | Expiry bounds (Unix seconds or dates), with formerOwner only. | |
expiresBefore | bigint | Date | ||
search | string | ||
match | "prefix" | "contains" | "prefix" | Whether search matches from the start of a label (prefix) or anywhere (contains). |
sort | "name" | "expiry" | "registered" | "created" | Field the rows are sorted by. | |
order | "asc" | "desc" | Sort direction. | |
dedupe | "name" | "registration" | One row per name, or per registration. @default "name" | |
address (required) | string | The address, all lowercase or checksummed. | |
coin | CoinType.Input | "evm" | Coin type for relation: "resolvesTo", or evm for every EVM chain. @default 60 | |
parent | string | Only direct children of this name. |
Also takes the read options.
Returns
Resolves to Page<AddressName>. One page of names, each with how the address relates to it.
Errors
| Error | Codes | When |
|---|---|---|
InvalidInputError | INVALID_ADDRESS, INVALID_COIN_TYPE, INVALID_NAME | invalid input. |
ConfigError | INDEXER_NOT_CONFIGURED | the client has no indexer. |
IndexerError | INDEXER_UNSUPPORTED | the indexer does not serve the query or its namespace. |
IndexerError | INDEXER_UNAVAILABLE, INDEXER_RATE_LIMITED, INDEXER_BEHIND, INDEXER_REQUEST_REJECTED, INDEXER_RESPONSE_INVALID | the indexer is unavailable, rate limiting, behind, rejects the request or answers unexpectedly. |
It can also fail with the errors every read can (Errors.CommonError: ConfigError, ContractRevertError, InternalError, NetworkError).
See How errors work.
Examples
const page = await ens.indexer.getNamesForAddress({ address: "0xb8c2…" })Example response
Recorded from Ethereum mainnet on 2026-11-18 at block 26443964. Values change as the chain does.
await ens.indexer.getNamesForAddress({ address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", limit: 3 }){
"asOf": {
"chainId": 1,
"blockNumber": "26443964n",
"blockHash": "0xe75c58ea2f28bd7c6cc53c28a5ab4fc02023f3563661f0a7236a36b779e3ac86",
"timestamp": "1795029143n"
},
"snapshots": {
"1": {
"chainId": 1,
"blockNumber": "26443964n",
"blockHash": "0xe75c58ea2f28bd7c6cc53c28a5ab4fc02023f3563661f0a7236a36b779e3ac86",
"timestamp": "1795029143n"
}
},
"asOfToken": null,
"completeness": "full",
"unsupportedReason": null,
"unsupportedFields": [],
"origin": null,
"indexer": "bigname",
"items": [
{
"name": "$ethereum.eth",
"displayName": "$ethereum.eth",
"namespace": "ens",
"node": "0x19dcf664810b0725d51d9e71dd02c5be734f14803394fb2d5574dfb8efd402a7",
"status": "active",
"authority": "ensV1",
"owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"manager": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"registeredAt": "1715951615n",
"createdAt": "1659177236n",
"expiresAt": "1815916415n",
"graceEndsAt": "1818335615n",
"expiryReason": null,
"ensV1": {
"resolver": {
"chainId": 1,
"address": "0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63"
},
"expiresAt": "1810559615n",
"wrapperState": "locked",
"wrapperExpiresAt": "1818335615n",
"wrapperFuses": 196609
},
"relations": [
"owner",
"manager"
],
"isPrimary": false,
"migratedAt": null,
"recordCount": null,
"subnameCount": null
},
{
"name": "$tmnt.eth",
"displayName": "$tmnt.eth",
"namespace": "ens",
"node": "0x0b6f1e9f5b9f267f7d9b57fad7971998a4710835d0c9007a02edc5d0f59c7960",
"status": "active",
"authority": "ensV1",
"owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"manager": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"registeredAt": "1750871663n",
"createdAt": "1703971235n",
"expiresAt": "1819300463n",
"graceEndsAt": "1821719663n",
"expiryReason": null,
"ensV1": {
"resolver": {
"chainId": 1,
"address": "0x231b0Ee14048e9dCcD1d247744d114a4EB5E8E63"
},
"expiresAt": "1813943663n",
"wrapperState": "emancipated",
"wrapperExpiresAt": "1821719663n",
"wrapperFuses": 196608
},
"relations": [
"owner",
"manager"
],
"isPrimary": false,
"migratedAt": null,
"recordCount": null,
"subnameCount": null
},
{
"name": "0x2cd.eth",
"displayName": "0x2cd.eth",
"namespace": "ens",
"node": "0x017e683f998ef30ad2d628fa36ade474ef6f40aa8fa042d87e41730273a7145c",
"status": "active",
"authority": "ensV1",
"owner": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
"manager": "0x32869721EF080442ec128FC1ddb6673006bc5aa9",
"registeredAt": "1651234372n",
"createdAt": "1651234372n",
"expiresAt": "1845932884n",
"graceEndsAt": "1848352084n",
"expiryReason": null,
"ensV1": {
"resolver": {
"chainId": 1,
"address": "0x4976fb03C32e5B8cfe2b6cCB31c09Ba78EBaBa41"
},
"expiresAt": "1840576084n",
"wrapperState": "unwrapped",
"wrapperExpiresAt": null,
"wrapperFuses": null
},
"relations": [
"owner"
],
"isPrimary": false,
"migratedAt": null,
"recordCount": null,
"subnameCount": null
}
],
"cursor": "7b2276657273696f6e223a312c22736f7274223a226e616d65222c2266696c74657273223a7b2261646472657373223a22307864386461366266323639363461663964376565643965303365353334313564333761613936303435222c22617574686f72697479223a22222c22646564757065223a226e616d65222c2269735f6d69677261746564223a22222c226e616d657370616365223a22222c226f72646572223a22617363222c2271223a22222c2272656c6174696f6e223a22227d2c226c6173745f6974656d223a7b226c6f676963616c5f6e616d655f6964223a22656e733a307830313765363833663939386566333061643264363238666133366164653437346566366634306161386661303432643837653431373330323733613731343563222c227265736f757263655f6964223a2232643539636630332d613131382d353862372d623264382d373033646561653936316336222c22736f72745f6b696e64223a226e616d65222c22736f72745f76616c7565223a2230783263642e657468227d2c22736e617073686f74223a6e756c6c7d",
"hasMore": true,
"totalCount": 90
}See also
paginatefrom@ensforge/sdk/indexerto walk every page
Was this page helpful?