---
title: "List Backups"
method: GET
path: "/v1/postgres/{postgres_cluster_id}/backups"
tags: ["Postgres Clusters"]
---

# List Backups

`GET /v1/postgres/{postgres_cluster_id}/backups`

List all backups associated with a specific cluster.

## Path parameters

- `postgres_cluster_id` string, required

## Response `200`

OK

- ListPostgresBackupsResponse
  - `data` PostgresBackup[]
    - `finished_at` string — RFC 3339 stop timestamp.
    - `id` string — Backup ID.
    - `size_bytes` integer — Backup size in bytes.
    - `started_at` string — RFC 3339 start timestamp.
    - `status` string — Backup status.
    - `type` 'full' | 'incr' | 'diff' — Backup type.

## Other responses

- `404` — Cluster not found

## Changes

- **2026-08-12** `f54480c4ce7f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/machines/apis/machines-api/changes/v1/postgres/:postgres_cluster_id/backups/get.md)

---

[API](https://skmtc.dev/machines/apis/machines-api.md) · [All operations](https://skmtc.dev/machines/apis/machines-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/machines/machines-api/revisions/80746f322f20/schema)