---
title: "List folders, files in one folder, and space used"
method: GET
path: "/v1/storage"
---

# List folders, files in one folder, and space used

`GET /v1/storage`

## Request

- Base URL: `https://api.payaion.com`
- URL: `https://api.payaion.com/v1/storage`
- Auth: one of:
  - API key in header `X-Aion-Key`
  - HTTP bearer

The account's whole folder tree (flat, each entry carrying its full path
and file count), the files sitting in the requested folder, and bytes
used against the plan limit.

Folders are metadata: they never affect retention, pricing or what a file
costs to store. Deleted and failed uploads are excluded, so the listing
and the quota always agree.

## Query parameters

- `folderId` string

## Response `200`

Folder tree, the requested folder's files, and usage

- StorageListing
  - `folder` object, nullable: The folder that was listed, or null for the storage root
    - `id` string, uuid
    - `name` string
    - `path` string
  - `folders` object[]: Every folder in the account, flat, each with its full path
    - `folderId` string, uuid
    - `name` string
    - `path` string
    - `parentId` string, nullable
    - `fileCount` integer
  - `files` object[]: Files in the requested folder
    - `uploadId` string
    - `fileName` string
    - `sizeBytes` integer
    - `status` string
    - `createdAt` string, date-time
    - `folderId` string, nullable
    - `pricePerDownload` string, nullable
    - `shareUrl` string, nullable
  - `usage` object: Whole-account storage usage — folders have no quota of their own
    - `plan` 'free' | 'pro'
    - `files` integer
    - `usedBytes` integer
    - `limitBytes` integer

## Other responses

- `401`: Invalid or missing credentials
- `403`: Scope denied or access forbidden
- `404`: Resource not found
- `422`: A field failed validation
- `429`: Rate limit exceeded

---

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