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

# Get Space Usage

> Get storage space usage for the current user or workspace

## Overview

Returns the current storage usage and available space for a user or workspace.

## Query Parameters

<ParamField query="workspaceId" type="integer">
  Workspace ID. Use `0` for the user's default personal workspace.
</ParamField>

## Response

<ResponseField name="used" type="integer">
  Total space used in bytes
</ResponseField>

<ResponseField name="available" type="integer">
  Available space in bytes
</ResponseField>

<ResponseField name="status" type="string">
  Request status (`success`)
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://app.drime.cloud/api/v1/user/space-usage?workspaceId=0" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://app.drime.cloud/api/v1/user/space-usage?workspaceId=0',
    {
      headers: {
        'Authorization': 'Bearer YOUR_ACCESS_TOKEN'
      }
    }
  );

  const { used, available } = await response.json();

  // Convert to GB
  const usedGB = (used / 1024 / 1024 / 1024).toFixed(2);
  const availableGB = (available / 1024 / 1024 / 1024).toFixed(2);

  console.log(`Used: ${usedGB} GB / Available: ${availableGB} GB`);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://app.drime.cloud/api/v1/user/space-usage',
      params={'workspaceId': 0},
      headers={'Authorization': 'Bearer YOUR_ACCESS_TOKEN'}
  )

  data = response.json()
  used_gb = data['used'] / 1024 / 1024 / 1024
  available_gb = data['available'] / 1024 / 1024 / 1024

  print(f"Used: {used_gb:.2f} GB / Available: {available_gb:.2f} GB")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "used": 120042057597,
    "available": 6597069766656,
    "status": "success"
  }
  ```
</ResponseExample>

<Note>
  The values are in bytes. To convert to GB, divide by `1024 * 1024 * 1024`.
</Note>