---
title: "Retrieve backups for a specific cluster"
method: GET
path: "/api/clusters/{clusterName}/restic/snapshots"
tags: ["ClusterRestic"]
---

# Retrieve backups for a specific cluster

`GET /api/clusters/{clusterName}/restic/snapshots`

This endpoint retrieves the backups for the specified cluster.

## Path parameters

- `clusterName` string, required

## Query parameters

- `format` 'default' | 'legacy'

## Headers

- `Authorization` string, required

## Response `200`

Snapshots with repository context

- ServerResticSnapshotsResponse
  - `repo_path` string
  - `snapshots` ServerResticSnapshotResponse[]
    - `gid` integer
    - `hostname` string
    - `id` string
    - `metadata` ClusterSnapshotMetadataSummary[]
      - `backupLine` string
      - `backupMethod` string
      - `backupSessionID` string
      - `backupTool` string
      - `compressed` boolean
      - `dest` string
      - `endTime` string
      - `resticBasePath` string
      - `resticSnapshotID` string
      - `startTime` string
    - `metadataError` string
    - `metadataReady` boolean
    - `metadataStatus` string
    - `paths` string[]
    - `short_id` string
    - `tags` string[]
    - `time` string
    - `tree` string
    - `uid` integer
    - `username` string
  - `stats` BackupmgrBackupStat
    - `total_blob_count` integer
    - `total_file_count` integer
    - `total_size` integer

## Other responses

- `403` — No valid ACL
- `500` — No cluster

---

[API](https://skmtc.net/signal18/apis/untitled-api.md) · [All operations](https://skmtc.net/signal18/apis/untitled-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signal18/untitled-api/revisions/7465ea0ee21a/schema)