# registration.isAvailable

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

Checks whether a .eth name can be registered now. Parameters, return value, errors and examples for registration.isAvailable in @ensforge/sdk.

Source: https://ensforge.com/docs/reference/sdk/registration/is-available

<ApiMeta kind="Read" stability="stable" since="1.0.0" source="packages/sdk/src/actions/registration/isAvailable/index.ts#L52" batchable />

Checks whether a `.eth` name can be registered now.

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

Use to show whether a name is free before quoting a price or starting a registration.

## Details [#details]

- Every new `.eth` name is registered on ENSv2, including names that expired on ENSv1, so one
  check covers both.
- Names in their grace period are not available; anyone can renew them, and the name is available again once the grace period ends.
- Labels the price oracle rejects (for example shorter than 3 characters) are not available.

## Signature [#signature]

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

Call it as `ens.registration.isAvailable(options)` on a client, or `Actions.registration.isAvailable(client, options)`.

`registration.isAvailable.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 [`useAvailability`](/docs/reference/react/use-availability).

## Parameters [#parameters]

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `name` (required) | `string` |  | `.eth` second-level name, e.g. `alice.eth`. Normalized automatically. |

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

## Returns [#returns]

Resolves to `boolean`. Whether the name can be registered.

## Errors [#errors]

| Error | Codes | When |
| --- | --- | --- |
| [`InvalidInputError`](/docs/reference/errors/invalid-input-error) | [`INVALID_NAME`](/docs/reference/errors/INVALID_NAME) | names that are not `.eth` second-level names. |
| [`UnsupportedError`](/docs/reference/errors/unsupported-error) | [`UNSUPPORTED_ON_DEPLOYMENT`](/docs/reference/errors/UNSUPPORTED_ON_DEPLOYMENT) | without ENSv2. |
| [`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 free = await ens.registration.isAvailable({ name: "alice.eth" })
```
</Tab>

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

const free = await Actions.registration.isAvailable(publicClient, { name: "alice.eth" })
```
</Tab>

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

const free = yield* Actions.registration.isAvailable(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.registration.isAvailable({ name: "nick.eth" })
```

```json
false
```

## See also [#see-also]

- [`registration.getPrice`](/docs/reference/sdk/registration/get-price) to quote it