# indexer.getNamesForAddress

> For the complete documentation index, see [llms.txt](https://ensforge.com/llms.txt).

Lists the names an address owns, manages, holds roles on, resolves to, or used to own. Options, result, errors and examples for indexer.getNamesForAddress.

Source: https://ensforge.com/docs/reference/sdk/indexer/get-names-for-address

<ApiMeta kind="Read" stability="stable" since="1.0.0" source="packages/sdk/src/actions/indexer/getNamesForAddress/index.ts#L57" batchable />

Lists the names an address owns, manages, holds roles on, resolves to, or used to own.

## When to use [#when-to-use]

Use to show an account's names, e.g. a "my names" page or a name picker.

## Details [#details]

- `relation` defaults to `any`: owner, manager and role holder. `resolvesTo` (with `coin`) and
  `formerOwner` are listed on their own.
- Lists every namespace the indexer serves unless `namespace` is set.
- Pages hold up to `limit` names (default 50, at most 200); pass `cursor` for the next page, or
  use `paginate`.

## Signature [#signature]

```ts
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](/docs/sdk/look-up-many-at-once).

In React, use [`useNamesForAddress`](/docs/reference/react/use-names-for-address).

## Parameters [#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](/docs/reference/sdk/client#read-options).

## Returns [#returns]

Resolves to `Page<AddressName>`. One page of names, each with how the address relates to it.

## Errors [#errors]

| Error | Codes | When |
| --- | --- | --- |
| [`InvalidInputError`](/docs/reference/errors/invalid-input-error) | [`INVALID_ADDRESS`](/docs/reference/errors/INVALID_ADDRESS), [`INVALID_COIN_TYPE`](/docs/reference/errors/INVALID_COIN_TYPE), [`INVALID_NAME`](/docs/reference/errors/INVALID_NAME) | invalid input. |
| [`ConfigError`](/docs/reference/errors/config-error) | [`INDEXER_NOT_CONFIGURED`](/docs/reference/errors/INDEXER_NOT_CONFIGURED) | the client has no indexer. |
| [`IndexerError`](/docs/reference/errors/indexer-error) | [`INDEXER_UNSUPPORTED`](/docs/reference/errors/INDEXER_UNSUPPORTED) | the indexer does not serve the query or its namespace. |
| [`IndexerError`](/docs/reference/errors/indexer-error) | [`INDEXER_UNAVAILABLE`](/docs/reference/errors/INDEXER_UNAVAILABLE), [`INDEXER_RATE_LIMITED`](/docs/reference/errors/INDEXER_RATE_LIMITED), [`INDEXER_BEHIND`](/docs/reference/errors/INDEXER_BEHIND), [`INDEXER_REQUEST_REJECTED`](/docs/reference/errors/INDEXER_REQUEST_REJECTED), [`INDEXER_RESPONSE_INVALID`](/docs/reference/errors/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](/docs/sdk/errors-explained).

## Examples [#examples]

<Tabs groupId="api" items={["Client","Standalone","Effect"]} persist>
<Tab>
```ts title="Listing an address's names"
const page = await ens.indexer.getNamesForAddress({ address: "0xb8c2…" })
```
</Tab>

<Tab>
```ts title="Listing names that resolve to an address with a standalone call"
import { Actions } from "@ensforge/sdk"

const page = await Actions.indexer.getNamesForAddress(ens, { address, relation: "resolvesTo" })
```
</Tab>

<Tab>
```ts title="Listing an address's names in an Effect program"
import { Actions } from "@ensforge/sdk/effect"

const page = yield* Actions.indexer.getNamesForAddress(ens, { address, sort: "expiry" })
```
</Tab>
</Tabs>

## Example response [#example-response]

Recorded from Ethereum mainnet on 2026-11-18 at block 26443964. Values change as the chain does.

```ts
await ens.indexer.getNamesForAddress({ address: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", limit: 3 })
```

```json
{
  "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 [#see-also]

- `paginate` from `@ensforge/sdk/indexer` to walk every page