# See file storage

Source: https://docs.vlayers.ai/reference/messages/get-storage-usage

`GET /v1/storage` · scope `messages:read`

How much room the files of your messages use (attachments and pictures from email, texts, WhatsApp and the rest), the limits that apply to your workspace (the biggest file, the most one message may hold and the whole workspace), how many files were not saved and why, and what the stored files cost per month. Identical files in one workspace are stored once. When storage is full, new messages are still accepted and their files are marked as not saved with the reason; sending files is refused with a plain sentence until space is freed.

Requires an API key with the `messages:read` scope.

## Request

cURL:

```bash
curl https://api.vlayers.ai/v1/storage \
  -H "Authorization: Bearer $VOICELAYER_API_KEY"
```

TypeScript:

```ts
import { VoiceLayer } from '@voicelayer/api';

const voicelayer = new VoiceLayer();

const { storage } = await voicelayer.messages.getStorageUsage();
console.log(storage.summary);
```

Python:

```python
from voicelayer import VoiceLayer

vl = VoiceLayer()

result = vl.messages.get_storage_usage()
print(result.storage.summary)
```

## Response `200`

```json
{
  "storage": {
    "usedBytes": 1240000000,
    "capBytes": 10737418240,
    "maxFileBytes": 26214400,
    "maxMessageBytes": 41943040,
    "fileCount": 312,
    "heldCount": 0,
    "percentUsed": 11,
    "full": false,
    "estimatedMonthlyUsd": 0.03,
    "summary": "You are using 1.2 GB of your 10 GB file storage (11%)."
  }
}
```
