# dns.getStatus

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

Reads whether a DNS name is imported into ENS, and what it needs to be. Parameters, return value, errors and examples for dns.getStatus in @ensforge/sdk.

Source: https://ensforge.com/docs/reference/sdk/dns/get-status

<ApiMeta kind="Read" stability="stable" since="1.0.0" source="packages/sdk/src/actions/dns/getStatus/index.ts#L55" batchable />

Reads whether a DNS name is imported into ENS, and what it needs to be.

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

Use to tell the user which step comes next, before [`dns.claim`](/docs/reference/sdk/dns/claim).

## Details [#details]

- Compares the ENSv1 registry owner with the address in the `_ens` TXT record, and verifies
  the record's DNSSEC proof against the on-chain DNSSEC oracle.
- `action` is the next step: `none`, `claim`, `set-txt-record` or `proof-invalid`.
- Gasless DNS names (`ENS1` TXT records) resolve without importing; see
  [`dns.getOffchainResolver`](/docs/reference/sdk/dns/get-offchain-resolver).

## Signature [#signature]

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

Call it as `ens.dns.getStatus(options)` on a client, or `Actions.dns.getStatus(client, options)`.

`dns.getStatus.request(options)` builds a deferred read for `Actions.batch`. See [Look up many at once](/docs/sdk/look-up-many-at-once).

## Parameters [#parameters]

| Option | Type | Default | Description |
| --- | --- | --- | --- |
| `name` (required) | `string` |  | DNS name. Normalized automatically. |
| `gatewayUrls` | `readonly string[]` |  | DNSSEC gateways to use instead of the deployment's. |

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

## Returns [#returns]

Resolves to `Status`. Import state and the next step.

| Field | Type | Description |
| --- | --- | --- |
| `name` | `string` | Normalized name. |
| `imported` | `boolean` | Whether the name is in the ENSv1 registry. |
| `owner` | `Address \| null` | ENSv1 registry owner, or `null` when not imported. |
| `dnsOwner` | `Address \| null` | Address in the `_ens` TXT record (`a=0x…`), or `null` when there is none. |
| `proofValid` | `boolean` | Whether the DNSSEC proof of the TXT record verifies against the on-chain DNSSEC oracle. |
| `importedInception` | `number \| null` | Inception of the last imported proof, or `null` when none was imported. |
| `proofInception` | `number` | Inception of the current DNSSEC proof. |
| `action` | `ImportAction` |  |

## Errors [#errors]

| Error | Codes | When |
| --- | --- | --- |
| [`InvalidInputError`](/docs/reference/errors/invalid-input-error) | [`INVALID_NAME`](/docs/reference/errors/INVALID_NAME) | names that are not DNS names. |
| [`GatewayError`](/docs/reference/errors/gateway-error) | [`GATEWAY_REQUEST_FAILED`](/docs/reference/errors/GATEWAY_REQUEST_FAILED), [`GATEWAY_RESPONSE_INVALID`](/docs/reference/errors/GATEWAY_RESPONSE_INVALID) | the DNSSEC gateway fails. |
| [`UnsupportedError`](/docs/reference/errors/unsupported-error) | [`UNSUPPORTED_ON_DEPLOYMENT`](/docs/reference/errors/UNSUPPORTED_ON_DEPLOYMENT) | without a DNSSEC gateway or `gatewayUrls`. |
| [`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 DNS name"
const status = await ens.dns.getStatus({ name: "example.com" })
```
</Tab>

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

const status = await Actions.dns.getStatus(publicClient, { name: "example.com" })
```
</Tab>

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

const status = yield* Actions.dns.getStatus(ens, { name: "example.com" })
```
</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.dns.getStatus({ name: "ens.domains" })
```

```json
{
  "name": "ens.domains",
  "imported": true,
  "owner": "0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5",
  "dnsOwner": "0xb8c2C29ee19D8307cb7255e1Cd9CbDE883A267d5",
  "proofValid": false,
  "importedInception": null,
  "proofInception": 1794939171,
  "action": "proof-invalid"
}
```

## See also [#see-also]

- [`dns.claim`](/docs/reference/sdk/dns/claim) to import it