---
title: "List database backups"
method: GET
path: "/database/{databaseId}/backup"
tags: ["Backups"]
---

# List database backups

`GET /database/{databaseId}/backup`

## Request

- Base URL: `https://api.qovery.com`
- URL: `https://api.qovery.com/database/{databaseId}/backup`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/qovery/apis/qovery-api/docs/database/:databaseId/backup/get.ts> (a function with typed inputs; its response is checked against the schema)

By default it returns the 20 last results. The response is paginated. In order to request the next page, you can use the startId query parameter

## Path parameters

- `databaseId` string, uuid, required

## Query parameters

- `startId` string, uuid

## Response `200`

List backups

- BackupPaginatedResponseList
  - `page` number, required
  - `page_size` number, required
  - `results` Backup[]
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time
    - `name` string, required
    - `message` string, required
    - `status` Status
      - `id` string, uuid, required
      - `state` 'BUILDING' | 'BUILD_ERROR' | 'CANCELED' | 'CANCELING' | 'DELETED' | 'DELETE_ERROR' | 'DELETE_QUEUED' | 'DELETING' | 'DEPLOYED' | 'DEPLOYING' | 'DEPLOYMENT_ERROR' | 'DEPLOYMENT_QUEUED' | 'EXECUTING' | 'QUEUED' | 'READY' | 'RECAP' | 'RESTARTED' | 'RESTARTING' | 'RESTART_ERROR' | 'RESTART_QUEUED' | 'STOPPED' | 'STOPPING' | 'STOP_ERROR' | 'STOP_QUEUED' | 'WAITING_DELETING' | 'WAITING_RESTARTING' | 'WAITING_RUNNING' | 'WAITING_STOPPING', required
      - `service_deployment_status` 'NEVER_DEPLOYED' | 'OUT_OF_DATE' | 'UP_TO_DATE', required
      - `last_deployment_date` string, date-time
      - `is_part_last_deployment` boolean
      - `steps` ServiceStepMetrics
        - `total_duration_sec` integer, nullable: The total duration in seconds of the service deployment or null if the deployment is not completed.
        - `total_computing_duration_sec` integer: The total duration in seconds of the service deployment without queuing steps.
        - `details` ServiceStepMetric[]: A list of metrics for deployment steps of the service.
          - `step_name` 'REGISTRY_CREATE_REPOSITORY' | 'GIT_CLONE' | 'BUILD_QUEUEING' | 'BUILD' | 'DEPLOYMENT_QUEUEING' | 'DEPLOYMENT' | 'ROUTER_DEPLOYMENT' | 'MIRROR_IMAGE' | 'EXECUTING': The name of the deployment step at the service level: - REGISTRY_CREATE_REPOSITORY: The step to create the repository in the registry. - GIT_CLONE: The step to clone the source code repository. - BUILD_QUEUEING: The queuing time preceding the actual building step. - BUILD: The step to build the source code. - DEPLOYMENT_QUEUEING: The queuing time preceding the actual deployment step. - DEPLOYMENT: The step to deploy the service. - ROUTER_DEPLOYMENT: The step to deploy the router. - MIRROR_IMAGE: The step to mirror the image to the private registry. - EXECUTING: The step to execute a job or terraform apply.
          - `status` 'SUCCESS' | 'ERROR' | 'CANCEL' | 'SKIP': The status of completion for the step: - SUCCESS: The step completed successfully. - ERROR: The step completed with an error. - CANCEL: The step was canceled. - SKIP: The step was skipped because it was not necessary.
          - `duration_sec` integer: The duration of the step in seconds.
      - `execution_id` string
      - `status_details` StatusDetails, required
        - `action` 'DEPLOY' | 'DELETE' | 'RESTART' | 'STOP' | 'UNKNOWN', required
        - `status` 'QUEUED' | 'ONGOING' | 'SUCCESS' | 'ERROR' | 'EXECUTING' | 'CANCELED' | 'CANCELING' | 'NEVER', required
      - `deployment_request_id` string, uuid, nullable
      - `deployment_requests_count` integer

## Other responses

- `401`: Access token is missing or invalid
- `403`: Access forbidden
- `404`: Resource not found

---

[API](https://skmtc.dev/qovery/apis/qovery-api.md) - [All operations](https://skmtc.dev/qovery/apis/qovery-api/llms.txt) - [OpenAPI document](https://skmtc.dev/qovery/apis/qovery-api/revisions/93c4960a44ba?raw)