---
title: "List shards snapshots for a collection"
method: GET
path: "/collections/{collection_name}/shards/{shard_id}/snapshots"
tags: ["Snapshots"]
---

# List shards snapshots for a collection

`GET /collections/{collection_name}/shards/{shard_id}/snapshots`

## Request

- Base URL: `http://localhost:6333`
- URL: `http://localhost:6333/collections/{collection_name}/shards/{shard_id}/snapshots`
- Auth: one of:
  - API key in header `api-key`
  - HTTP bearer
  - none
- TypeScript: <https://skmtc.dev/qdrant/apis/qdrant-api/docs/collections/:collection_name/shards/:shard_id/snapshots/get.ts> (a function with typed inputs; its response is checked against the schema)

Get list of snapshots for a shard of a collection

## Path parameters

- `collection_name` string, required
- `shard_id` integer, required

## Response `200`

successful operation

- object
  - `usage` union
    - Usage: Usage of the hardware resources, spent to process the request
      - `hardware` union
        - HardwareUsage: Usage of the hardware resources, spent to process the request
          - `cpu` integer, required
          - `payload_io_read` integer, required
          - `payload_io_write` integer, required
          - `payload_index_io_read` integer, required
          - `payload_index_io_write` integer, required
          - `vector_io_read` integer, required
          - `vector_io_write` integer, required
        - unknown
      - `inference` union
        - InferenceUsage
          - `models` object, required
        - unknown
    - unknown
  - `time` number, float: Time spent to process this request
  - `status` string
  - `result` SnapshotDescription[]
    - `name` string, required
    - `creation_time` string, partial-date-time, nullable
    - `size` integer, required
    - `checksum` string, nullable

## Other responses

- `default`: error
- `4XX`: error

## Changes

- **2025-11-17** `d09f337ca2f3`: 2 info
  - added `#/components/schemas/Usage` to the `usage` response property `anyOf` list for the response status `200`
  - removed `#/components/schemas/HardwareUsage` from the `usage` response property `anyOf` list for the response status `200`
- **2025-04-15** `5d330acca4cd`: 2 breaking, 6 info
  - removed the required property `usage/anyOf[#/components/schemas/HardwareUsage]/io_read` from the response with the `200` status
  - removed the required property `usage/anyOf[#/components/schemas/HardwareUsage]/io_write` from the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_index_io_read` to the response with the `200` status
  - added the required property `usage/anyOf[#/components/schemas/HardwareUsage]/payload_index_io_write` to the response with the `200` status
  - …4 more
- **2025-01-17** `a7900f38a79d`: 4 info
  - api tag `Snapshots` added
  - api tag `collections` removed
  - api tag `snapshots` removed
  - added the optional property `usage` to the response with the `200` status

[Operation history](https://skmtc.dev/qdrant/apis/qdrant-api/changes/collections/:collection_name/shards/:shard_id/snapshots/get.md)

---

[API](https://skmtc.dev/qdrant/apis/qdrant-api.md) - [All operations](https://skmtc.dev/qdrant/apis/qdrant-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qdrant/apis/qdrant-api/revisions/c93be9a86fe5?raw)