# migration.get

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

Reads whether an ENSv1 name can migrate to ENSv2, how, and what it becomes. Parameters, return value, errors and examples for migration.get in @ensforge/sdk.

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

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

Reads whether an ENSv1 name can migrate to ENSv2, how, and what it becomes.

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

Use to drive a migration screen: route, blockers, resolver plan and the state after.

## Details [#details]

- `status`: `eligible`, `blocked` (see `blockers`), `migrated` or `not-required` (already
  on ENSv2, or not registered).
- `blockers` are checked for `account` (the client's account by default).
- `resolver.plan` shows what [`migration.migrate`](/docs/reference/sdk/migration/migrate) does with the current
  resolver for the same `resolver` option.
- With an indexer, `discovered` lists the records and subnames `migrate` carries over by
  default (read at the latest block).

## Signature [#signature]

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

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

`migration.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 [`useMigrationStatus`](/docs/reference/react/use-migration-status).

## Parameters [#parameters]

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `name` (required) | `string` |  | ENS name. Normalized automatically. |
| `account` | `string` |  | Account that would migrate. Defaults to the client's account. |
| `resolver` | `"new" \| "owned" \| "keep" \| (string & {})` |  | The `resolver` option `migrate` would get. |

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

## Returns [#returns]

Resolves to `get.ReturnType`. Route, blockers, holder, resolver plan and the ENSv2 state after migrating.

## Errors [#errors]

| Error | Codes | When |
| --- | --- | --- |
| [`InvalidInputError`](/docs/reference/errors/invalid-input-error) | [`INVALID_NAME`](/docs/reference/errors/INVALID_NAME), [`INVALID_ADDRESS`](/docs/reference/errors/INVALID_ADDRESS) | invalid input. |
| [`UnsupportedError`](/docs/reference/errors/unsupported-error) | [`UNSUPPORTED_ON_DEPLOYMENT`](/docs/reference/errors/UNSUPPORTED_ON_DEPLOYMENT) | where ENSv2 is not deployed. |
| [`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="Checking a name"
const status = await ens.migration.get({ name: "alice.eth" })
```
</Tab>

<Tab>
```ts title="Checking a name with a standalone call"
import { Actions } from "@ensforge/sdk"

const status = await Actions.migration.get(publicClient, { name: "alice.eth" })
```
</Tab>

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

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

```json
{
  "name": "nick.eth",
  "status": "migrated",
  "route": null,
  "blockers": [],
  "owner": null,
  "manager": null,
  "fuses": null,
  "expiry": null,
  "reservationExpiry": null,
  "resolver": {
    "current": null,
    "plan": "none"
  },
  "after": {
    "registry": null,
    "subregistry": null,
    "expiry": null,
    "roles": []
  },
  "discovered": null
}
```

## See also [#see-also]

- [`migration.migrate`](/docs/reference/sdk/migration/migrate) to migrate it