---
title: "List all restore activities"
method: GET
path: "/endpoints/v1/restores"
tags: ["Endpoints"]
---

# List all restore activities

`GET /endpoints/v1/restores`

Returns the list of all the restore activities performed on user devices with their details.

## Query parameters

- `deviceID` integer
- `targetDeviceID` integer
- `userID` integer
- `minStartTime` string
- `maxStartTime` string
- `pageToken` string

## Response `200`

OK

- RestoreList
  - `totalSize` integer — The total number of restore activities listed in the result pages. Example: 4096
  - `nextPageToken` string — The token to access the next page of results. This parameter will be empty for the last page of results.
  - `restores` Restore[]
    - `deviceID` integer — The unique ID of the device from which the restore activity was triggered. Example: 12345
    - `targetDeviceID` integer — The device ID of the device to which the data was restored. Example: 12345
    - `restoreLocation` string — The location on the device to which the data was restored. The possibles locations are: 1) Original: If the data was restored to the original location 2) Desktop: If the data was restored to desktop 3)Custom location: If data was restored to a custom location 4) Unknown: If the restore was performed from a mobile device to a mobile device.
    - `userID` integer — The unique ID of the user who triggered the restore activity. Example: 12345
    - `restoreID` integer — The unique ID of the restore activity. This value is 'null' in case of restore was initiated from a mobile device. Example: 12345
    - `startTime` string, date-time — The start time of the restore activity. Example: 2013-04-17T09:12:36Z
    - `endTime` string, date-time — The end time of the restore activity. Example: 2013-04-17T09:13:36Z. This value is empty if the restore activity is ongoing.
    - `status` string — Status of the restore activity. It is: 1) Successful: If the restore activity was completed successfully. 2) Ongoing: If the restore activity is ongoing. 3) Failed: If the restore activity was failed. 4) Cancelled: If the restore activity was cancelled manually. 5) Completed with Errors: If some files were missed during the restore activity.
    - `restoreSize` string — The size of the data restored. Example: 285 MB This value is 'Unknown' for restores that failed to start.
    - `numberOfFilesRestored` integer — The total number of files that were restored in the restore activity. Example: 456
    - `numberOfFilesMissed` integer — The total number of files that were missed from the restore activity. Example: 12 This value is 'null' if the restore activity is ongoing.
    - `restoreMode` string — The persona who initiated the restore. Personas are: Self: inSync user himself Admin: Administrator.
    - `systemSettingsRestore` boolean — This returns 'true' if system setting were restored else returns 'false'.
    - `failureReason` string — This returns the failure reason if the status is 'failed' else returns 'empty.

## Other responses

- `400` — Bad Request
- `401` — The request did not include an authentication token or an expired authentication token was supplied.
- `404` — The requested resource was not found.
- `500` — The request was not processed due to an internal error in inSync GovCloud.
- `501` — Requested HTTP method is not implemented.

---

[API](https://skmtc.net/druva/apis/authentication.md) · [All operations](https://skmtc.net/druva/apis/authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/druva/authentication/versions/2af2bf148b25/schema)