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

# Get Storage Statistics

> Retrieve storage usage statistics for your organization

Returns comprehensive statistics about your organization's storage usage including total size, file counts, and usage breakdowns.

## Authorization

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication. Format: `Bearer <your-api-key>`
</ParamField>

## Required Permission

`STORAGE_READ`

## Response

<ResponseField name="totalStorage" type="number">
  Total storage allocation in bytes
</ResponseField>

<ResponseField name="usedStorage" type="number">
  Currently used storage in bytes
</ResponseField>

<ResponseField name="overageStorage" type="number">
  Overage storage in bytes (usage beyond allocation)
</ResponseField>

<ResponseField name="breakdown" type="StorageBreakdown[]">
  Breakdown of storage by file kind
</ResponseField>

<Expandable title="StorageBreakdown properties">
  <ResponseField name="kind" type="string">
    File kind: `image`, `video`, `audio`, or `document`
  </ResponseField>

  <ResponseField name="count" type="number">
    Number of files of this kind
  </ResponseField>

  <ResponseField name="size" type="number">
    Total size in bytes for this kind
  </ResponseField>
</Expandable>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.nonefivem.com/cloud/storage" \
    -H "Authorization: Bearer your-api-key"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch("https://api.nonefivem.com/cloud/storage", {
    headers: {
      Authorization: "Bearer your-api-key"
    }
  });
  const statistics = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "totalStorage": 5368709120,
    "usedStorage": 1073741824,
    "overageStorage": 0,
    "breakdown": [
      {
        "kind": "image",
        "count": 120,
        "size": 536870912
      },
      {
        "kind": "video",
        "count": 25,
        "size": 429496729
      },
      {
        "kind": "audio",
        "count": 5,
        "size": 107374183
      }
    ]
  }
  ```
</ResponseExample>