---
title: "Get storage usage and caps"
method: GET
path: "/api/user/storage"
tags: ["Account"]
---

# Get storage usage and caps

`GET /api/user/storage`

## Request

- Base URL: `https://api.engram.page`
- URL: `https://api.engram.page/api/user/storage`
- Auth: HTTP bearer

Returns the user's current attachment storage usage and file count alongside the total storage cap and the per-file size limit resolved from their plan. On self-host (limits not enforced) the per-file cap is reported as the Pro ceiling.

## Response `200`

Storage usage

- StorageUsage
  - `file_count` integer, required
  - `max_attachment_bytes` integer, required: Per-file cap for the user's plan.
  - `max_bytes` integer, required
  - `used_bytes` integer, required

---

[API](https://skmtc.dev/engram/apis/engram-api.md) · [All operations](https://skmtc.dev/engram/apis/engram-api/llms.txt) · [OpenAPI document](https://skmtc.dev/engram/apis/engram-api/revisions/8c4c2eec29dc?raw)