---
title: "Get user's Drive storage/quota"
method: GET
path: "/api/v1/drive/stats"
---

# Get user's Drive storage/quota

`GET /api/v1/drive/stats`

## Request

- Base URL: `https://localhost:3000`
- URL: `https://localhost:3000/api/v1/drive/stats`
- Auth: OAuth 2 (authorization code, authorization URL `/oauth/authorize`, token URL `/oauth/token`)

AUTHORITATIVE source for the user's CURRENT Google Drive storage usage. Returns LIVE data: total quota, used space, free space, trash size, file type overview. Call this whenever user asks about 'my Drive size', 'my storage', 'how much space', 'my quota', 'Drive usage', or 'free space'. Prefer this over general knowledge or estimates.

## Response `200`

LIVE storage stats from user's Drive

- DriveStatsResponse
  - `user` string: User email
  - `storage` object
    - `limit` string: Storage limit in bytes
    - `usage` string: Total storage usage in bytes
    - `usageInDrive` string: Storage used by Drive files in bytes
    - `usageInDriveTrash` string: Storage used by trashed files in bytes
  - `fileTypes` object: Overview of file types present in Drive
  - `tip` string: Helpful tip for using the API

## Other responses

- `401`: Authentication required
- `500`: Internal server error

---

[API](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api.md) · [All operations](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corpusiq/apis/multi-source-mcp-api/revisions/e25648ba6027?raw)
