---
title: "List instance backup schedules"
method: GET
path: "/instances/{instanceId}/backup-schedules"
tags: ["Backup Schedules"]
---

# List instance backup schedules

`GET /instances/{instanceId}/backup-schedules`

## Request

- Base URL: `https://api.cloudpepper.io`
- URL: `https://api.cloudpepper.io/instances/{instanceId}/backup-schedules`
- Auth: HTTP bearer

List instance backup schedules

## Response `200`

Backups schedules retrieved successfully

- object[]
  - `id` string: ID
  - `instanceId` string, uuid: Instance ID
  - `schedule` string: Cron expression defining when the backup should run. Format: 'minute hour day-of-month month day-of-week'. Supported special values: - @monthly: Run once a month, first day at midnight ('00 00 1 * *') - @weekly: Run once a week, Sunday at midnight ('00 00 * * 0') - @daily, @midnight: Run once a day at midnight ('00 00 * * *') - @hourly: Run once an hour at the start of the hour ('00 * * * *') Supported interval patterns: - '00 */12 * * *': Run every 12 hours - '00 */6 * * *': Run every 6 hours - '00 */3 * * *': Run every 3 hours Standard cron examples: - '00 08 * * *': Run daily at 8:00 AM (UTC) - '00 20 * * *': Run daily at 8:00 PM (UTC) - '00 00 1 * *': Run at midnight on the first day of each month - '00 00 * * 0': Run at midnight on Sunday
  - `retention` integer: Number of days to retain the backup. Common values: 7 (one week), 30 (one month), 90 (three months), 365 (one year).
  - `providerId` string, uuid: Optional ID of a specific backup provider to use. If not specified, the default provider will be used.

## Other responses

- `403`: Insufficient permissions (requires admin privileges)

---

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