---
title: "List backups"
method: GET
path: "/v1/databases/{databaseID}/backups"
tags: ["Backups"]
---

# List backups

`GET /v1/databases/{databaseID}/backups`

## Request

- Base URL: `https://api.liara.ir`
- URL: `https://api.liara.ir/v1/databases/{databaseID}/backups`
- Auth: HTTP bearer

Lists a database's backups, newest first. Not available for `elasticsearch` and `rabbitmq`. How often backups are made and how long they're kept depends on the bundle plan. Team permission: `view`, `operate` or `manage`.

## Path parameters

- `databaseID` string, required: 24-character hexadecimal ID.

## Query parameters

- `teamID` string: 24-character hexadecimal ID.

## Response `200`

The database's backups.

- object
  - `backups` Backup[]
    - `name` string: `<interval>/<file>`. Use it for downloads and for creating a database from a backup.
    - `size` integer: Size in bytes.
    - `lastModified` string, date-time
    - `etag` string

## Other responses

- `400`: The database ID or `teamID` is invalid, or this database type doesn't support backups.
- `401`: The API token is missing, invalid or expired.
- `403`: With `teamID`: you aren't a member of the team (`team_not_found`), or you don't have the required permission on this database (`no_permission`).
- `404`: The database doesn't exist.

---

[API](https://skmtc.dev/liara-cloud/apis/dbaas.md) - [All operations](https://skmtc.dev/liara-cloud/apis/dbaas/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/dbaas/revisions/f6f78c6f05c6?raw)