---
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`

## Request

- Base URL: `https://sylve.lan:8181/api`
- URL: `https://sylve.lan:8181/api/cluster/backups/targets/{id}/datasets/snapshots`
- Auth: API key in header `Authorization`

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

[Operation 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/9565cdd0abf5?raw)