---
title: "Show VFS stats"
method: POST
path: "/vfs/stats"
---

# Show VFS stats

`POST /vfs/stats`

Returns VFS statistics including disk cache usage and metadata cache counters.

## Query parameters

- `fs` string
- `_group` string
- `_async` boolean

## Headers

- `Prefer` 'respond-async'

## Request body

- VfsStatsRequest
  - `fs` string — Optional VFS identifier whose statistics should be returned.
  - `_group` string — Assign the request to a custom stats group.
  - `_async` boolean — Run the command asynchronously. Returns a job id immediately.

## Response `200`

Runtime statistics for a VFS, including disk cache and metadata cache state.

- object
  - `fs` string, required — Name of the VFS.
  - `inUse` integer, required — Number of active references to the VFS.
  - `diskCache` object, nullable — Disk cache metrics when caching is enabled.
  - `metadataCache` object, required — In-memory metadata cache counters.
  - `opt` object, required — Effective options applied to the VFS.

## Other responses

- `202` — Request accepted for async processing. Poll /job/status with the returned jobid.
- `4XX` — Any error response (HTTP 4xx/5xx)
- `5XX` — Any error response (HTTP 4xx/5xx)

---

[API](https://skmtc.net/rclone/apis/rclone-rc-api.md) · [All operations](https://skmtc.net/rclone/apis/rclone-rc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rclone/rclone-rc-api/versions/2849bf2803ce/schema)