---
title: "Return completed restoration tasks list"
method: GET
path: "/restore_queue_list_completed"
tags: ["Account Restoration", "Restore Queue Reporting"]
---

# Return completed restoration tasks list

`GET /restore_queue_list_completed`

This function lists the restoration queue's completed tasks.

**Important:**

This function's output varies dramatically. The [`/usr/local/cpanel/bin/backup_restore_manager`](https://go.cpanel.net/backuprestoremanagerscript) script run with the `list_finished` option determines this output..

**Note:**

On servers that run CentOS 7, you may see a `named` warning about the absence of SPF resource records on DNS.
  * This warning is **not** relevant on CentOS 7 servers, because [RFC 7208](https://tools.ietf.org/html/rfc7208) deprecated SPF records. CentOS 7 servers use TXT records instead of SPF records.
  * Red Hat 7.1 and CentOS 7.1 both contain `bind-9.9.4-23.el7`, which is an updated version of BIND that complies with RFC 7208. To resolve this issue, update your operating system to a version that contains the updated version of BIND. For more information, read the [Red Hat Bugzilla case about SPF record errors](https://bugzilla.redhat.com/show_bug.cgi?id=1215164).

## Response `200`

HTTP Request was successful.

- object
  - `data` object
    - `restore_job` object[] — An array of objects that contain information about a completed task in the restoration queue.
      - `restore_job` object — An object that contains the task's settings.
        - `options` object — An object that contains information about the task's options.
          - `destid` string — The destination's identification string. * `local` — The local directory. * The destination ID string's value.
          - `give_ip` 0 | 1 — Whether the task assigned the account a dedicated IP address. * `1` - Assigned. * `0` - Did **not** assign.
          - `mail_config` 0 | 1 — Whether the function restored the account's email configuration. * `1` - Restored. * `0` - Did **not** restore.
          - `mysql` 0 | 1 — Whether the task restored the account's MySQL® databases. * `1` - Restored. * `0` - Did **not** restore.
          - `subdomains` 0 | 1 — Whether the function restored the account's subdomains. * `1` - Restored. * `0` - Did **not** restore.
        - `restore_point` string, ISO-8601 Date — The date of the backup that the task used.
        - `user` string, username — The cPanel account's username.
      - `status_info` object — An object that contains information about the task's status.
        - `altered_items` integer, nullable — The number of items that the restoration process changed.
        - `dangerous_items` integer, nullable — The number of items in the restoration process that may cause problems on the account.
        - `finished` string, unix_timestamp — The time that the restoration process completed this task.
        - `log` string — The task's log information.
        - `restore_logfile` string — The restoration log file's name.
        - `result` 0 | 1 | 2 — Whether the task completed successfully. * `1` - Success. * `0` - Failure. * `2` - Warning.
        - `skipped_items` integer, nullable — The number of items that the restoration process skipped.
        - `started` string, unix_timestamp — The restoration process's start time for this task.
        - `transfer_session_id` string — The restoration transfer session's ID.
        - `warnings` string[], nullable — Any warnings about the restoration process.
  - `metadata` object
    - `command` string — The method name called.
    - `reason` string — The reason the API function failed when the `metadata.result` field is `0`. This field may display a success message when a function succeeds.
    - `result` 0 | 1 — * `1` - Success. * `0` - Failed. Check the `reason` field for more details.
    - `version` integer — The version of the API function.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)