---
title: "List Snapshots"
method: GET
path: "/backup/snapshots"
tags: ["backup"]
---

# List Snapshots

`GET /backup/snapshots`

List all snapshots or filter by app ID

## Query parameters

- `app_id` string — App ID to filter snapshots by (optional)

## Response `200`

Successful Response

- BackupSnapshot[]
  - `time` string, required — Snapshot creation time
  - `parent` string, nullable — Parent snapshot ID
  - `tree` string, required — Tree hash
  - `paths` string[], required — Paths included in the snapshot
  - `hostname` string, required — Hostname of the backup
  - `username` string, required — Username of the backup creator
  - `tags` string[], required — Tags associated with the snapshot
  - `program_version` string, required — Restic program version
  - `summary` BackupSnapshotSummary, required
    - `backup_start` string, required — Backup start time
    - `backup_end` string, required — Backup end time
    - `files_new` integer, required — Number of new files
    - `files_changed` integer, required — Number of changed files
    - `files_unmodified` integer, required — Number of unmodified files
    - `dirs_new` integer, required — Number of new directories
    - `dirs_changed` integer, required — Number of changed directories
    - `dirs_unmodified` integer, required — Number of unmodified directories
    - `data_blobs` integer, required — Number of data blobs
    - `tree_blobs` integer, required — Number of tree blobs
    - `data_added` integer, required — Data added in bytes
    - `data_added_packed` integer, required — Packed data added in bytes
    - `total_files_processed` integer, required — Total files processed
    - `total_bytes_processed` integer, required — Total bytes processed
  - `id` string, required — Snapshot ID
  - `short_id` string, required — Shortened snapshot ID

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

## Changes

- **2026-04-23** `e4bf692cc15e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/websoft9/apis/appmanae-api/changes/backup/snapshots/get.md)

---

[API](https://skmtc.dev/websoft9/apis/appmanae-api.md) · [All operations](https://skmtc.dev/websoft9/apis/appmanae-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/websoft9/appmanae-api/revisions/e4bf692cc15e/schema)