# name.get

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

Reads the full state of a name across ENSv1 and ENSv2: where it lives, who owns it, its resolver, expiry and whether it can be registered or renewed.

Source: https://ensforge.com/docs/reference/sdk/name/get

<ApiMeta kind="Read" stability="stable" since="1.0.0" source="packages/sdk/src/actions/name/get/index.ts#L67" batchable />

Reads the full state of a name across ENSv1 and ENSv2: where it lives, who owns it, its
resolver, expiry and whether it can be registered or renewed.

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

Use when a UI needs to know about a name: owner, expiry, grace period, availability, or
which protocol to send writes to.

## Details [#details]

- `kind` tells where the name lives (`v1-unwrapped`, `v1-wrapped`, `v2-native`, `v2-migrated`,
  `v2-reserved`, `available`); `protocol` is `v1` or `v2`.
- Times come from the block the read runs at, not the local clock.
- `inheritedResolver` is the resolver serving a name that has none of its own: a parent's
  wildcard or off-chain resolver, or the ENSv1 resolver behind the ENSv1 bridge.
- Costs two batched RPC calls, whatever the name kind. A name without a resolver of its own
  that a parent's resolver serves costs one more (two behind the ENSv1 bridge).

<Callout type="warn" title="Gotchas">
- `resolver` is the resolver set on the name itself. A name served only by a parent's wildcard
  or off-chain resolver (such as `jesse.base.eth`) has `resolver: null` and is in no registry,
  so it is `available` although it resolves: check `inheritedResolver`.
</Callout>

## Signature [#signature]

```ts
function get(client: Like, options: get.Options): Promise<get.ReturnType>
```

Call it as `ens.name.get(options)` on a client, or `Actions.name.get(client, options)`.

`name.get.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 [`useName`](/docs/reference/react/use-name).

## Parameters [#parameters]

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `name` (required) | `string` |  | ENS name to read. Normalized automatically. |

Also takes the [read options](/docs/reference/sdk/client#read-options).

## Returns [#returns]

Resolves to `NameState`. The name's full state.

| Field | Type | Description |
| --- | --- | --- |
| `name` | `string` | The normalized name. |
| `kind` | `NameKind` |  |
| `protocol` | `"v1" \| "v2"` | Protocol that controls the name. |
| `status` | `NameStatus` |  |
| `owner` | `Address \| null` | Who ultimately controls the name: the ENSv2 token holder; on ENSv1 the NameWrapper token holder, the `.eth` registrant, or otherwise the registry owner. |
| `manager` | `Address \| null` | ENSv1 registry owner of an unwrapped name (the ENS app's "manager"). |
| `registrant` | `Address \| null` | ENSv1 `.eth` registrar token holder of an unwrapped second-level name. |
| `registry` | `Address \| null` | Registry that holds the name: ENSv1 `ENSRegistry`, or the ENSv2 parent registry. |
| `subregistry` | `Address \| null` | ENSv2 registry for the name's children. |
| `resolver` | `Address \| null` | Resolver set on the name itself (not inherited from a parent). |
| `inheritedResolver` | `Address \| null` | For a name without a resolver of its own, the resolver that serves it from an ancestor: a parent's ENSIP-10 wildcard or off-chain resolver, or, for an ENSv1 name ENSv2 serves through the ENSv1 bridge, the ENSv1 resolver behind it. `null` when the name has its own resolver or nothing serves it. A name only an inherited resolver serves is in no registry, so it can be `available` and still resolve. |
| `expiry` | `bigint \| null` | Unix seconds when the registration ends, grace period excluded. `null` when it never expires. |
| `gracePeriodEnd` | `bigint \| null` | Unix seconds when the `.eth` grace period ends. |
| `tokenId` | `bigint \| null` | Token ID: ENSv2 registry token (changes on some role updates), NameWrapper or `.eth` registrar token. |
| `resource` | `bigint \| null` | ENSv2 resource ID, stable across token changes. |
| `ttl` | `bigint \| null` | ENSv1 registry TTL in seconds. |
| `wrapped` | `boolean` | Whether the name is wrapped in the ENSv1 NameWrapper. |
| `migrated` | `boolean` | Whether the name was migrated from ENSv1 to ENSv2. |
| `reachable` | `boolean` | Whether ENSv2 resolution reaches the name. An ENSv1 name is reachable when the resolver ENSv2 resolution finds for it reads ENSv1: the ENSv1 bridge (a reservation, a migrated parent that kept it as resolver, an emancipated child of a locked parent) or a DNS TLD resolver. `false` when ENSv2 answers from elsewhere, e.g. a parent that migrated without the name or a `.eth` name without a reservation: its ENSv1 records no longer resolve, nor do its children's. Always `true` for ENSv2 names and on deployments without ENSv2. |
| `available` | `boolean` | Whether the name can be registered now. |
| `renewable` | `boolean` | Whether the name can be renewed now (`.eth` second-level names when registered or in grace). |

## Errors [#errors]

| Error | Codes | When |
| --- | --- | --- |
| [`InvalidInputError`](/docs/reference/errors/invalid-input-error) | [`INVALID_NAME`](/docs/reference/errors/INVALID_NAME) | the name is invalid or the root. |
| [`NetworkError`](/docs/reference/errors/network-error) | [`RPC_REQUEST_FAILED`](/docs/reference/errors/RPC_REQUEST_FAILED), [`RPC_TIMEOUT`](/docs/reference/errors/RPC_TIMEOUT), [`RATE_LIMITED`](/docs/reference/errors/RATE_LIMITED) | the RPC request fails. |

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="Showing a renewal banner"
const state = await ens.name.get({ name: "alice.eth" })
if (state.status === "grace") showRenewBanner(state.gracePeriodEnd)
```
</Tab>

<Tab>
```ts title="Reading with a bare viem client"
import { Actions } from "@ensforge/sdk"

const { owner, expiry } = await Actions.name.get(publicClient, { name: "nick.eth" })
```
</Tab>

<Tab>
```ts title="Reading in an Effect program"
import { Actions } from "@ensforge/sdk/effect"

const state = yield* Actions.name.get(ens, { name: "nick.eth" })
```
</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.name.get({ name: "nick.eth" })
```

```json
{
  "name": "nick.eth",
  "kind": "v2-migrated",
  "protocol": "v2",
  "status": "registered",
  "owner": "0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5",
  "manager": null,
  "registrant": null,
  "registry": "0xf60aba43E1f7F3DAB1186Ff03B561401C9Df85E2",
  "subregistry": "0x02cA46F62f6C9F655364bf9Fd4f11Fb8f01C5753",
  "resolver": "0xF4f1007EA430848F2fAd60e405A54Fc100fEc341",
  "expiry": "2051983306n",
  "gracePeriodEnd": "2054402506n",
  "tokenId": "42219085255511335250589442208301538195142221433306354426240614732610656010240n",
  "resource": "42219085255511335250589442208301538195142221433306354426240614732610656010240n",
  "ttl": null,
  "wrapped": false,
  "migrated": true,
  "available": false,
  "renewable": true,
  "reachable": true,
  "inheritedResolver": null
}
```

## See also [#see-also]

- [`resolver.get`](/docs/reference/sdk/resolver/get) to describe the resolver
- [`name.transfer`](/docs/reference/sdk/name/transfer) to send a name