---
title: "Changes to List backups"
method: GET
path: "/organizations/{organization}/databases/{database}/branches/{branch}/backups"
---

# Changes to List backups

`GET /organizations/{organization}/databases/{database}/branches/{branch}/backups`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 24 revisions.

- **2026-08-18** `249942995489` — 2 info
- **2026-08-11** `4b2e4f05bda2` — 1 info
- **2026-07-08** `fa19f3305241` — 1 info
- **2026-06-01** `72506953f367` — 22 breaking, 2 info
- **2025-12-09** `d710019068fb` — 2 breaking
- **2025-12-04** `5e881928d77a` — 2 breaking, 11 info

## Changes

- **2026-08-18** `249942995489` — 2 info
  - added the required property `total_count` to the response with the `200` status
  - added the required property `total_pages` to the response with the `200` status
- **2026-08-11** `4b2e4f05bda2` — 1 info
  - added the required property `per_page` to the response with the `200` status
- **2026-07-08** `fa19f3305241` — 1 info
  - added the required property `data/items/uncompressed_size` to the response with the `200` status
- **2026-06-01** `72506953f367` — 22 breaking, 2 info
  - the response property `data/items/actor` became nullable for the status `200`
  - the response property `data/items/backup_policy` became nullable for the status `200`
  - the response property `data/items/backup_policy/last_ran_at` became nullable for the status `200`
  - the response property `data/items/backup_policy/next_run_at` became nullable for the status `200`
  - the response property `data/items/backup_policy/schedule_day` became nullable for the status `200`
  - the response property `data/items/backup_policy/schedule_week` became nullable for the status `200`
  - the response property `data/items/completed_at` became nullable for the status `200`
  - the response property `data/items/database_branch` became nullable for the status `200`
  - the response property `data/items/database_branch/deleted_at` became nullable for the status `200`
  - the response property `data/items/deleted_at` became nullable for the status `200`
  - the response property `data/items/expires_at` became nullable for the status `200`
  - the response property `data/items/restored_branches/items/deleted_at` became nullable for the status `200`
  - the response property `data/items/schema_snapshot` became nullable for the status `200`
  - the response property `data/items/schema_snapshot/linted_at` became nullable for the status `200`
  - the response property `data/items/started_at` became nullable for the status `200`
  - the response property `next_page` became nullable for the status `200`
  - the response property `next_page_url` became nullable for the status `200`
  - the response property `prev_page` became nullable for the status `200`
  - the response property `prev_page_url` became nullable for the status `200`
  - the response property `data/items/backup_policy` became optional for the status `200`
  - the response property `data/items/database_branch` became optional for the status `200`
  - the response property `data/items/schema_snapshot` became optional for the status `200`
  - added the required property `data/items/backup_policy/display_name` to the response with the `200` status
  - added the required property `type` to the response with the `200` status
- **2025-12-09** `d710019068fb` — 2 breaking
  - for the `query` request parameter `page`, the type/format was changed from `number`/`` to `integer`/``
  - for the `query` request parameter `per_page`, the type/format was changed from `number`/`` to `integer`/``
- **2025-12-04** `5e881928d77a` — 2 breaking, 11 info
  - the `data/items/backup_policy/schedule_day` response's property type/format changed from `string`/`` to `number`/`` for status `200`
  - the `data/items/backup_policy/schedule_week` response's property type/format changed from `string`/`` to `number`/`` for status `200`
  - removed the `0.00` enum value from the `data/items/backup_policy/schedule_day` response property for the response status `200`
  - removed the `0.00` enum value from the `data/items/backup_policy/schedule_week` response property for the response status `200`
  - removed the `1.00` enum value from the `data/items/backup_policy/schedule_day` response property for the response status `200`
  - removed the `1.00` enum value from the `data/items/backup_policy/schedule_week` response property for the response status `200`
  - removed the `2.00` enum value from the `data/items/backup_policy/schedule_day` response property for the response status `200`
  - removed the `2.00` enum value from the `data/items/backup_policy/schedule_week` response property for the response status `200`
  - removed the `3.00` enum value from the `data/items/backup_policy/schedule_day` response property for the response status `200`
  - removed the `3.00` enum value from the `data/items/backup_policy/schedule_week` response property for the response status `200`
  - removed the `4.00` enum value from the `data/items/backup_policy/schedule_day` response property for the response status `200`
  - removed the `5.00` enum value from the `data/items/backup_policy/schedule_day` response property for the response status `200`
  - removed the `6.00` enum value from the `data/items/backup_policy/schedule_day` response property for the response status `200`

---

[Operation](https://skmtc.dev/planetscale/apis/planetscale-api/docs/organizations/:organization/databases/:database/branches/:branch/backups/get.md) · [API](https://skmtc.dev/planetscale/apis/planetscale-api.md) · [Page](https://skmtc.dev/planetscale/apis/planetscale-api/changes/organizations/:organization/databases/:database/branches/:branch/backups/get)
