---
title: "List all the Curated Snapshots."
method: GET
path: "/curatedsnapshot/v1/snapshots"
tags: ["Curated Snapshots"]
---

# List all the Curated Snapshots.

`GET /curatedsnapshot/v1/snapshots`

## Request

- Base URL: `https://apis.druva.com/realize`
- URL: `https://apis.druva.com/realize/curatedsnapshot/v1/snapshots`
- Auth: API key in header `Authorization`

Lists all the Curated Snapshots.

## Query parameters

- `sortOrder` 'asc' | 'desc'
- `sortBy` 'jobID' | 'status' | 'resourceName'
- `resourceName` string
- `status[]` string[]
- `resourceType[]` string[]
- `retainedFor` 'Next 24 Hours' | 'Next 7 Days' | 'Next 1 Month', date
- `pageToken` string

## Response `200`

OK

- CSListSnapshotsResponse
  - `snapshots` object[]
    - `jobID` integer: ID of Curated Snapshot Job.
    - `resourceID` integer: ID of resource for which restore job is created in inSync or Phoenix.
    - `resourceName` string: Name of resource for which restore job is created in inSync or Phoenix.
    - `resourceType` string: Type of resource for which restore job is created in inSync or Phoenix.
    - `resourceURL` string: Link to resource for which Curated Snapshot job is executed.
    - `restoreURL` string: Link to resource for which Curated Snapshot job is executed.
    - `platformType` string
    - `ssRangeStartDate` string, date: Start date from which snapshots are considered for creation of Curated Snapshot
    - `ssRangeEndDate` string, date: End date till when snapshots are considered for creation of Curated Snapshot
    - `expiry` string, date: Date till when Curated Snapshot is retained.
    - `enableAVScan` boolean: Flag stating if AV Scan is enabled while creating Curated Snapshot. This is always True
    - `excludeFileHashes` boolean: Flag stating if File Hash Scan is enabled while creating Curated Snapshot. This is always True
    - `excludeFileExtentions` boolean: Boolean flag to include files extensions for exclusion based on the added extensions.
    - `fileExtentions` string[]
    - `replaceExistingSnapshot` boolean: Flag to decide if existing Curated Snapshot should be replaced by a newer one.
    - `virtualSnapshotID` string: Base-64 encoded name of Curated Snapshot created by the job.
    - `virtualSnapshotEpoch` integer: Epoch timestamp of Curated Snapshot created by the job.
    - `virtualSnapshotName` string: Storage name of Curated Snapshot created by the job.
    - `displaySnapshotName` string: Display name of Curated Snapshot created by the job.
    - `size` integer: Size of Curated Snapshot created in bytes.
    - `statusCode` integer: Current status code of Curated Snapshot.
    - `status` string: Current status of Curated Snapshot.
    - `filesIncluded` integer: Files included in Curated Snapshot.
    - `filesScanedSkipped` integer: Files skipped from scan by Scan Engine
    - `filesExcluded` integer: Files excluded with extension exclusion from Curated Snapshot by Scan Engine.
    - `filesBlocked` integer: Files blocked be Scan service while creating Curated Snapshot.
    - `filesEncrypted` integer: Files excluded from Curated Snapshot as they were found to be encrypted
  - `nextPageToken` string: The token to access the next page of results. This parameter will be empty for the last page of the results. For example - eyJpZCI6NTY1NX0=
  - `totalItems` integer: Total snapshots present in the response.

## Other responses

- `400`: Bad Request
- `401`: The request either did not include an authentication token, or you have provided an expired authentication token.
- `404`: The requested resource was not found.
- `500`: Internal Server Error

---

[API](https://skmtc.dev/druva/apis/cyber-resilience.md) - [All operations](https://skmtc.dev/druva/apis/cyber-resilience/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/cyber-resilience/revisions/b149d46c996a?raw)