# permission.get

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

Reads what an account may do with an ENS name: transfer it, change its resolver, edit records, create subnames and more, across ENSv1 ownership and ENSv2 roles.

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

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

Reads what an account may do with an ENS name: transfer it, change its resolver, edit records,
create subnames and more, across ENSv1 ownership and ENSv2 roles.

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

Use to enable or hide actions in a UI before the user tries them.

## Details [#details]

- ENSv1: the owner, operators and approved addresses, limited by NameWrapper fuses.
- ENSv2: the account's roles on the name and at the root of its registry. The deployment's
  current UserRegistry checks `renew` at its root only (contracts-v2 #505).
- Records: PermissionedResolver roles, or owner, operator and delegates on public resolvers.
  Pass `records` for per-record answers, e.g. which text keys the account may write.
- `null` means the permission model is unknown (a custom resolver).
- Costs three batched calls.

## Signature [#signature]

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

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

`permission.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 [`usePermissions`](/docs/reference/react/use-permissions).

## Parameters [#parameters]

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `name` (required) | `string` |  | ENS name. Normalized automatically. |
| `account` | `string` | the client's account | Account to check. |
| `records` | `Selection` |  | Records to answer for one by one, in the `record.get` selection shape. |

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

## Returns [#returns]

Resolves to `get.ReturnType`. What the account may do; `null` when unknown.

| Field | Type | Description |
| --- | --- | --- |
| `account` | `Address` |  |
| `status` | `NameStatus` |  |
| `can` | `{ readonly [operation in NameOperation \| "setRecords"]: boolean \| null }` |  |
| `records` (optional) | `Readonly<Record<string, unknown>>` | Per-record answers, shaped like the `records` selection. |
| `fuses` | `readonly Fuse.Name[]` | Burned NameWrapper fuses (wrapped ENSv1 names). |

## 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. |
| [`ConfigError`](/docs/reference/errors/config-error) | [`WALLET_NOT_CONFIGURED`](/docs/reference/errors/WALLET_NOT_CONFIGURED) | without `account` or a client account. |
| [`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="Gating a UI"
const { can } = await ens.permission.get({ name: "alice.eth", account })
if (can.setRecords) showEditButton()
```
</Tab>

<Tab>
```ts title="Per-record access with a standalone call"
import { Actions } from "@ensforge/sdk"

const { records } = await Actions.permission.get(publicClient, { name: "alice.eth", account, records: { texts: ["url"] } })
```
</Tab>

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

const permissions = yield* Actions.permission.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.permission.get({ name: "nick.eth", account: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" })
```

```json
{
  "account": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
  "status": "registered",
  "can": {
    "transfer": false,
    "setResolver": false,
    "setSubregistry": false,
    "createSubname": false,
    "removeSubname": false,
    "renew": true,
    "setTtl": false,
    "setManager": false,
    "reclaim": false,
    "setRecords": false
  },
  "fuses": []
}
```

## See also [#see-also]

- [`permission.check`](/docs/reference/sdk/permission/check) for one operation and what is missing