# DatabaseBackup

> The DatabaseBackup object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `id` * | string |  |
| `database_id` * | string |  |
| `kind` * | `base`, `snapshot`, `logical` |  |
| `trigger` * | `scheduled`, `manual`, `pre_restore`, `pre_delete`, `pre_upgrade` |  |
| `status` * | `running`, `completed`, `failed` |  |
| `size_bytes` | integer or null |  |
| `locations` | array of `uk-primary`, `uk-secondary`, `eu` |  |
| `restore_test` | object or null |  |
| `started_at` * | string (date-time) |  |
| `finished_at` | string (date-time) or null |  |
| `expires_at` | string (date-time) or null |  |

\* always present

## Example

```json
{
  "id": "bak_01jbx2m9k7q4r8t5v6w3y0z1pr",
  "database_id": "string",
  "kind": "base",
  "trigger": "scheduled",
  "status": "running",
  "size_bytes": 1,
  "locations": [
    "uk-primary"
  ],
  "restore_test": {
    "status": "passed",
    "at": "2026-10-22T13:05:00Z"
  },
  "started_at": "2026-10-22T13:05:00Z",
  "finished_at": "2026-10-22T13:05:00Z",
  "expires_at": "2026-10-22T13:05:00Z"
}
```

## Used by

- [Get a backup](/docs/api/databases/#get-a-backup)