---
title: "Get service backup information"
method: GET
path: "/project/{project}/service/{service_name}/backups"
tags: ["Service"]
---

# Get service backup information

`GET /project/{project}/service/{service_name}/backups`

## Path parameters

- `project` string, required
- `service_name` string, required

## Response `200`

Response

- ServiceBackupsGetResponse — ServiceBackupsGetResponse
  - `backup_progress` string — Scheduled time for the next backup
  - `backups` object[], required — List of backups for the service
    - `additional_regions` object[] — Additional backup regions, if available
      - `cloud` string, required — Target cloud
      - `pause_reason` string — Reason for pausing the backup synchronization
      - `paused` boolean — Indicates additional backup synchronization is paused
      - `region` string — Cloud storage region name
    - `backup_name` string, required — Internal name of this backup
    - `backup_time` string, required — Backup timestamp (ISO 8601)
    - `data_size` integer, required — Backup's original size before compression
    - `incremental` boolean — Indicates if this backup is a full or an incremental one (available only for MySQL)
    - `storage_location` string — Location where this backup is stored
    - `tiered_storage_data_size` integer — The amount of tiered storage data in bytes referenced by this backup.
  - `errors` object[] — List of errors occurred during request processing
    - `message` string, required — Printable error message
    - `more_info` string — URL to the documentation of the error
    - `status` integer, required — HTTP error status code
  - `message` string — Printable result of the request
  - `pitr` object — Point-in-time-recovery metadata for the service. If not set, service type does not support PITR.
    - `additional_regions` object[], required — Empty array if BTAR is not enabled or BTAR+PITR is not supported.
      - `cloud` string, required — Target cloud
      - `pitr_range_end` string, required — Latest timestamp usable for PITR (ISO 8601) (always set)
      - `pitr_range_start` string, required — Earliest timestamp usable for PITR (ISO 8601) (always set)
      - `region` string, required — Cloud storage region name
    - `primary_region` object, required — Point-in-time-recovery metadata related to the primary backup location of the service.
      - `pitr_range_end` string, required — Latest timestamp usable for PITR (ISO 8601) (null means current time)
      - `pitr_range_start` string, required — Earliest timestamp usable for PITR (ISO 8601) (null means no available backup for PITR)
  - `scheduled_backup_time` object — Scheduled time and frequency of service backups
    - `backup_hour` integer — The hour of day (in UTC) when backup for the service is started. New backup is only started if previous backup has already completed.
    - `backup_interval_hours` integer — Service backup interval in hours
    - `backup_minute` integer — The minute of an hour when backup for the service is started. New backup is only started if previous backup has already completed.

---

[API](https://skmtc.net/aiven/apis/aiven-api-documentation.md) · [All operations](https://skmtc.net/aiven/apis/aiven-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aiven/aiven-api-documentation/versions/ecaeabf1da31/schema)