v8

latestOpenAPI 3.0.0Apache 2.0raw.githubusercontent.com2025-10-165266542.4 MB

DigitalOcean-public.v2-new_Databases

List Backups for a Database Cluster

To list all of the available backups of a PostgreSQL or MySQL database cluster, send a GET request to /v2/databases/$DATABASE_ID/backups. Note: Backups are not supported for Caching or Valkey clusters. The result will be a JSON object with a backups key. This will be set to an array of backup objects, each of which will contain the size of the backup and the timestamp at which it was created.

get/v2/databases/{database_cluster_uuid}/backups

Path parameters

database_cluster_uuidstring uuid required

A unique identifier for a database cluster.

Response

A JSON object with a key of database_backups.

backup_progressstring

If a backup is currently in progress, this attribute shows the percentage of completion. If no backup is in progress, this attribute will be hidden.

Example response

{
  "backups": [
    {
      "created_at": "2019-01-31T19:25:22Z",
      "size_gigabytes": 0.03364864
    }
  ],
  "scheduled_backup_time": {
    "backup_hour": 20,
    "backup_minute": 40,
    "backup_interval_hours": 24
  },
  "backup_progress": "36"
}