---
title: "List Backups interface"
method: GET
path: "/list"
tags: ["Backup"]
---

# List Backups interface

`GET /list`

List all backups in current storage

## Query parameters

- `collection_name` string

## Headers

- `request_id` string

## Response `200`

OK

- BackuppbListBackupsResponse
  - `code` 0 | 1 | 2 | 3 | 400 | 404
  - `data` BackuppbBackupSummary[] — backup info entities
    - `id` string
    - `milvus_version` string
    - `name` string
    - `size` integer
  - `msg` string — error msg if fail
  - `requestId` string — uuid of the request to response

## Changes

- **2024-09-09** `f203f0a1ea90` — 1 info
  - the `query` request parameter `collection_name` became optional
- **2024-02-05** `d8bcd89ae6ed` — 1 info
  - the `header` request parameter `request_id` became optional
- **2022-12-06** `71cc25935ab4` — 2 breaking
  - added the new required `header` request parameter `request_id`
  - added the new required `query` request parameter `collection_name`
- **2022-11-28** `0f7ec556718b` — 2 warning
  - deleted the `header` request parameter `request_id`
  - deleted the `query` request parameter `collection_name`

[Change history](https://skmtc.dev/zilliztech/apis/milvus-backup-service/changes/list/get.md)

---

[API](https://skmtc.dev/zilliztech/apis/milvus-backup-service.md) · [All operations](https://skmtc.dev/zilliztech/apis/milvus-backup-service/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zilliztech/milvus-backup-service/revisions/f9b1b1989810/schema)