---
title: "Get an environment's backup list"
method: GET
path: "/projects/{projectId}/environments/{environmentId}/backups"
tags: ["Environment Backups"]
---

# Get an environment's backup list

`GET /projects/{projectId}/environments/{environmentId}/backups`

Retrieve a list of objects representing backups of this environment.

## Path parameters

- `projectId` string, required
- `environmentId` string, required

## Response `default`

- Backup[]
  - `id` string, required — The identifier of Backup
  - `created_at` string, date-time, nullable, required — The creation date
  - `updated_at` string, date-time, nullable, required — The update date
  - `attributes` object, required — Arbitrary attributes attached to this resource
  - `status` 'CREATED' | 'DELETING', required — The status of the backup
  - `expires_at` string, date-time, nullable, required — Expiration date of the backup
  - `index` integer, nullable, required — The index of this automated backup
  - `commit_id` string, required — The ID of the code commit attached to the backup
  - `environment` string, required — The environment the backup belongs to
  - `safe` boolean, required — Whether this backup was taken in a safe way
  - `size_of_volumes` integer, nullable, required — Total size of volumes backed up
  - `size_used` integer, nullable, required — Total size of space used on volumes backed up
  - `deployment` string, nullable, required — The current deployment at the time of backup
  - `restorable` boolean, required — Whether the backup is restorable
  - `automated` boolean, required — Whether the backup is automated

---

[API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)
