---
title: "Current stats snapshot"
method: POST
path: "/core/stats"
---

# Current stats snapshot

`POST /core/stats`

Returns active transfer statistics including bytes transferred, speed, and error counts.

## Query parameters

- `group` string
- `short` boolean
- `_group` string
- `_async` boolean

## Headers

- `Prefer` 'respond-async'

## Request body

- CoreStatsRequest
  - `group` string — Stats group identifier to return a snapshot for. Leave unset to include all groups.
  - `short` boolean — When true, omit the `transferring` and `checking` arrays from the response.
  - `_group` string — Assign the request to a custom stats group.
  - `_async` boolean — Run the command asynchronously. Returns a job id immediately.

## Response `200`

Current transfer statistics including totals, rates, and recent activity.

- object
  - `bytes` number, required
  - `checks` number, required
  - `deletedDirs` number, required
  - `deletes` number, required
  - `elapsedTime` number, required
  - `errors` number, required
  - `eta` number, nullable
  - `fatalError` boolean, required
  - `lastError` string
  - `retryError` boolean, required
  - `renames` number, required
  - `listed` number
  - `serverSideCopies` number, required
  - `serverSideCopyBytes` number, required
  - `serverSideMoveBytes` number, required
  - `serverSideMoves` number, required
  - `speed` number, required
  - `totalBytes` number, required
  - `totalChecks` number, required
  - `totalTransfers` number, required
  - `transferTime` number, required
  - `transfers` number, required
  - `transferring` CoreStatsTransfer[] — Active transfers currently in progress grouped by stats group.
    - `bytes` number — Bytes transferred so far for this object.
    - `eta` number, nullable — Estimated seconds remaining, when available.
    - `group` string — Stats group name associated with this transfer.
    - `name` string — Remote path of the object being transferred.
    - `percentage` number — Completion percentage from 0-100.
    - `size` number — Total size in bytes of the object.
    - `speed` number — Current transfer speed in bytes per second.
    - `speedAvg` number — Current speed in bytes per second as an exponentially weighted moving average.
    - `srcFs` string — Source remote or filesystem for this transfer.
    - `dstFs` string — Destination remote or filesystem for this transfer.
    - `srcRemote` string — Source path within srcFs.
    - `dstRemote` string — Destination path within dstFs.
  - `checking` CoreStatsChecking[] — Objects currently undergoing verification operations.
    - `group` string — Stats group name associated with this verification.
    - `name` string — Remote path of the object being verified.
    - `size` number — Total size in bytes of the object.

## 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)