> ## Documentation Index
> Fetch the complete documentation index at: https://upstash-dx-3009-array-sdk-docs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ARINFO

> Inspect array size, storage layout, and append position.

## Arguments

<ParamField body="key" type="string" required>
  The array key.
</ParamField>

<ParamField body="options" type="Object">
  <ParamField body="full" type="boolean">
    Include per-slice statistics. Defaults to false. Enabling this walks the whole array.
  </ParamField>
</ParamField>

## Response

<ResponseField type="ArInfoResult" required>
  An object with camelCase field names in TypeScript, or a dictionary with snake\_case field names in Python. A missing key raises an error.
</ResponseField>

| Field             | Type     | Meaning                                                     |
| ----------------- | -------- | ----------------------------------------------------------- |
| `len`             | `string` | Highest occupied index plus one.                            |
| `count`           | `number` | Number of occupied slots.                                   |
| `sliceSize`       | `number` | Indexes covered by one slice.                               |
| `slices`          | `number` | Allocated slices.                                           |
| `directorySize`   | `number` | Slice directory entries.                                    |
| `superDirEntries` | `number` | Top-level directory entries.                                |
| `nextInsertIndex` | `string` | Next append position.                                       |
| `denseSlices`     | `number` | Dense slices. Only with full statistics.                    |
| `sparseSlices`    | `number` | Sparse slices. Only with full statistics.                   |
| `avgDenseSize`    | `number` | Average values per dense slice. Only with full statistics.  |
| `avgDenseFill`    | `number` | Average dense-slice fill ratio. Only with full statistics.  |
| `avgSparseSize`   | `number` | Average values per sparse slice. Only with full statistics. |

<RequestExample>
  ```ts Example theme={"system"}
  await redis.arinsert("events", "boot", "ready");
  const info = await redis.arinfo("events");
  console.log(info.len, info.count, info.nextInsertIndex); // "2", 2, "2"
  const fullInfo = await redis.arinfo("events", { full: true });
  console.log(fullInfo.denseSlices, fullInfo.sparseSlices);
  ```
</RequestExample>

See the [server command reference](/redis/commands/array/arinfo) for protocol details.