# indexer.getNamespace

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

Reads what the indexer serves for a namespace: its networks and which features are complete. Options, result, errors and examples for indexer.getNamespace.

Source: https://ensforge.com/docs/reference/sdk/indexer/get-namespace

<ApiMeta kind="Read" stability="stable" since="1.0.0" source="packages/sdk/src/actions/indexer/getNamespace/index.ts#L46" batchable />

Reads what the indexer serves for a namespace: its networks and which features are complete.

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

Use to decide which features to show, e.g. hide verified records where they are unsupported.

## Signature [#signature]

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

Call it as `ens.indexer.getNamespace(options)` on a client, or `Actions.indexer.getNamespace(client, options)`.

`indexer.getNamespace.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 |
| --- | --- | --- | --- |
| `namespace` | `Namespace` | `"ens"` |  |

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

## Returns [#returns]

Resolves to `Result<NamespaceInfo> | null`. The namespace's coverage, or `null` when the indexer does not know it.

## Errors [#errors]

| Error | Codes | When |
| --- | --- | --- |
| [`NotFoundError`](/docs/reference/errors/not-found-error) | [`INDEXER_NOT_FOUND`](/docs/reference/errors/INDEXER_NOT_FOUND) | with `strict: true` when the indexer does not know the namespace. |
| [`ConfigError`](/docs/reference/errors/config-error) | [`INDEXER_NOT_CONFIGURED`](/docs/reference/errors/INDEXER_NOT_CONFIGURED) | the client has no indexer. |
| [`IndexerError`](/docs/reference/errors/indexer-error) | [`INDEXER_UNSUPPORTED`](/docs/reference/errors/INDEXER_UNSUPPORTED) | the indexer does not serve the query or its namespace. |
| [`IndexerError`](/docs/reference/errors/indexer-error) | [`INDEXER_UNAVAILABLE`](/docs/reference/errors/INDEXER_UNAVAILABLE), [`INDEXER_RATE_LIMITED`](/docs/reference/errors/INDEXER_RATE_LIMITED), [`INDEXER_BEHIND`](/docs/reference/errors/INDEXER_BEHIND), [`INDEXER_REQUEST_REJECTED`](/docs/reference/errors/INDEXER_REQUEST_REJECTED), [`INDEXER_RESPONSE_INVALID`](/docs/reference/errors/INDEXER_RESPONSE_INVALID) | the indexer is unavailable, rate limiting, behind, rejects the request or answers unexpectedly. |

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="Reading ENS coverage"
const ens_ = await ens.indexer.getNamespace()
```
</Tab>

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

const basenames = await Actions.indexer.getNamespace(ens, { namespace: "basenames" })
```
</Tab>

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

const info = yield* Actions.indexer.getNamespace(ens, { namespace: "ens" })
```
</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.indexer.getNamespace({ namespace: "ens" })
```

```json
{
  "namespace": "ens",
  "capabilities": {
    "name_history": "full",
    "name_profile": "full",
    "subnames": "full",
    "verified_primary_name": "full",
    "verified_records": "full"
  },
  "networks": [
    {
      "network": "ethereum",
      "chainId": 1,
      "protocol": "ensV2",
      "sinceBlock": "26183742n"
    }
  ],
  "asOf": null,
  "snapshots": {},
  "asOfToken": null,
  "completeness": "full",
  "unsupportedReason": null,
  "unsupportedFields": [],
  "origin": null,
  "indexer": "bigname"
}
```