---
title: "Get storage usage"
method: GET
path: "/v1/storage"
tags: ["Account"]
---

# Get storage usage

`GET /v1/storage`

## Request

- Base URL: `https://nanostudiopro.com/api`
- URL: `https://nanostudiopro.com/api/v1/storage`
- Auth: HTTP bearer

Total bytes used (originals + variants + uploads) versus your plan's quota. Generations and asset uploads both count against this. Use it to surface a usage meter in your client, or to gate uploads when you're approaching the limit.

## Response `200`

Storage stats

- Storage
  - `used_bytes` integer
  - `limit_bytes` integer
  - `used_percentage` number: Percentage 0–100 with 2 decimal places.
  - `plan` string

## Other responses

- `401`: Missing or invalid token
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api.md) · [All operations](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nanostudiopro/apis/nano-studio-pro-api/revisions/b454211e598e?raw)