> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dreep.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> Storage consumed and object counts with dreep.getUsage().

```ts theme={null}
const { storageBytes, imageCount, fileCount, folderCount } = await dreep.getUsage();
```

## Parameters

Takes no arguments beyond an optional `signal`.

## Returns

```ts theme={null}
{
  storageBytes: 170461024,
  imageCount: 109,
  fileCount: 19,
  folderCount: 11,
}
```

`storageBytes` is normalised to a number by the SDK — the API sends it as a string, since
the underlying column is a `BIGINT`.

## Reporting

```ts theme={null}
const { storageBytes, imageCount, fileCount } = await dreep.getUsage();

console.log(
  `${(storageBytes / 1024 ** 3).toFixed(2)} GB across ${imageCount + fileCount} assets`,
);
```

To find out what happens when a plan limit is reached, see
[`DreepLimitError`](/node-sdk/errors#plan-limits) — it carries the feature, the ceiling and
current consumption at the moment a request was rejected.