---
title: "List the current user's full-account backups"
method: GET
path: "/BackupInfo/list"
tags: ["BackupInfo"]
---

# List the current user's full-account backups

`GET /BackupInfo/list`

Scans the current cPanel user's home directory for full-account backup archives and returns one entry per archive, deriving real status from the on-disk marker file cPanel writes during a run. Single source of truth for the available-backups table. Read-only.

## Response `200`

HTTP Request was successful.

- object
  - `apiversion` integer
  - `func` string
  - `module` string
  - `result` object
    - `data` object[]
      - `name` string — The archive file name (basename only; never an absolute path).
      - `fullpath` string — The home-relative file name (basename; safe to echo). Never an absolute path.
      - `mtime` integer — Archive modification time, epoch seconds.
      - `sizeBytes` integer — Size of the .tar.gz archive in bytes.
      - `status` 'ready' | 'inprogress' | 'timeout' — Archive status derived from the marker file. 'ready' (marker absent), 'inprogress' (marker present, within timeout), or 'timeout' (marker present, stalled past the timeout threshold).
      - `startedAtEpoch` integer, nullable — Start epoch read from the marker file while a run is active. Null when not running.
    - `errors` string[]
    - `messages` string[]
    - `status` integer
    - `warnings` string[]

---

[API](https://skmtc.net/cpanel/apis/cpanel-uapi.md) · [All operations](https://skmtc.net/cpanel/apis/cpanel-uapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/cpanel-uapi/revisions/632e2f8e6d04/schema)