---
title: "List the backups of one database or volume"
method: GET
path: "/api/projects/{projectName}/backups/list"
tags: ["backups"]
---

# List the backups of one database or volume

`GET /api/projects/{projectName}/backups/list`

## Request

- Base URL: `https://api.hostim.dev`
- URL: `https://api.hostim.dev/api/projects/{projectName}/backups/list`
- Auth: HTTP bearer

Returns the successful backups of one resource, newest first. Backups that restic has pruned are left out.

## Path parameters

- `projectName` string, required

## Query parameters

- `kind` 'postgres' | 'mysql' | 'volume', required
- `name` string, required

## Response `200`

OK

- BackupList: The backups of one resource, newest first.
  - `items` Backup[], required
    - `id` string, required: The restic short snapshot ID
    - `time` string, date-time, required: When the backup ran
    - `trigger` string, required: What created the backup
    - `sizeBytes` integer: Full size of the backed up data. Missing for backups made before sizes were recorded.

## Other responses

- `400`: Missing or unknown kind or name
- `401`: User is not authorized
- `404`: Project not found
- `500`: Internal server error

---

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