---
title: "List Backup Target Dataset Snapshots"
method: GET
path: "/cluster/backups/targets/{id}/datasets/snapshots"
tags: ["Cluster Backups"]
---

# List Backup Target Dataset Snapshots

`GET /cluster/backups/targets/{id}/datasets/snapshots`

List restorable snapshots for a dataset on a backup target

## Path parameters

- `id` integer, required

## Query parameters

- `dataset` string, required
- `limit` integer
- `cursor` string

## Response `200`

Success

- GithubComAlchemillahqSylveInternalAPIResponseGithubComAlchemillahqSylveInternalServicesZeltaSnapshotPage
  - `data` GithubComAlchemillahqSylveInternalServicesZeltaSnapshotPage
    - `hasMore` boolean
    - `items` GithubComAlchemillahqSylveInternalServicesZeltaSnapshotInfo[]
      - `childCount` integer — number of child datasets on the target
      - `committed` boolean — verified c1 commit marker is present
      - `creation` string — creation timestamp
      - `dataset` string — dataset portion (without @snap)
      - `encrypted` boolean
      - `guid` string
      - `legacy` boolean — restore point predates commit manifests
      - `lineage` string — "active" | "rotated" | "other"
      - `name` string — full dataset@snap name
      - `outOfBand` boolean — true when snapshot is outside the active lineage
      - `refer` string — referenced size
      - `shortName` string — just the @snap portion
      - `used` string — space used
    - `nextCursor` string
  - `error` string
  - `message` string
  - `status` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Backup Target Not Found
- `409` — Backup Target Disabled
- `500` — Internal Server Error
- `502` — Remote Target Failure
- `503` — Local Key Unavailable
- `504` — Remote Target Timeout

## Changes

- **2026-09-04** `dcdbaed083a0` — 2 info
  - added the new optional `query` request parameter `cursor`
  - added the new optional `query` request parameter `limit`
- **2026-08-12** `9a5026bf9057` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/cluster/backups/targets/:id/datasets/snapshots/get.md)

---

[API](https://skmtc.dev/alchemillahq/apis/sylve-api.md) · [All operations](https://skmtc.dev/alchemillahq/apis/sylve-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alchemillahq/apis/sylve-api/revisions/6d4b8bb77d9a?raw)