---
title: "List endpoint backups"
method: GET
path: "/endpoints/v1/backups"
tags: ["Endpoints"]
---

# List endpoint backups

`GET /endpoints/v1/backups`

## Request

- Base URL: `https://apis.druva.com/insync`
- URL: `https://apis.druva.com/insync/endpoints/v1/backups`
- Auth: API key in header `Authorization`

Returns the details of last successful backups of all user devices.

## Query parameters

- `lastSuccessful` boolean, required
- `deviceID` integer
- `userID` integer
- `pageToken` string
- `minBackupStartTime` string, date-time
- `maxBackupStartTime` string, date-time
- `minBackupEndTime` string, date-time
- `maxBackupEndTime` string, date-time

## Response `200`

OK

- BackupList
  - `totalSize` integer
  - `nextPageToken` string: The token to access next page of results. This parameter will be empty for the last page of results.
  - `backups` Backup[]
    - `deviceID` integer: It is unique postive integer id associated with device.
    - `backupStatus` 'Completed': Backup status of the device
    - `filesBackedUp` integer: The number of files backed up in the last successful backup.
    - `bytesTransferred` integer: The number of bytes transferred in the last successful backup.
    - `filesMissed` integer: The number of files missed on the device in the last successful backup.
    - `snapshotSize` string: The size of the snapshot generated in the last successful backup in MBs.
    - `startTime` string, date-time: The start time of the last successful backup. Example - 2019-10-25T00:00:00Z
    - `endTime` string, date-time: The end time of the last successful backup. Example - 2019-10-25T00:00:00Z
    - `systemSettingsBackedUp` boolean: Specifies whether the system settings were backed up as part of the backup.

## Other responses

- `400`: Bad Request
- `401`: The request did not include an authentication token or an expired authentication token was supplied.
- `403`: Access denied: Insufficient permissions. User requires specific access rights and minimum permissions. Details: https://help.druva.com/en/articles/15069296
- `404`: The requested resource was not found.
- `500`: The request was not processed due to an internal error in inSync Cloud.
- `501`: Requested HTTP method is not implemented.

---

[API](https://skmtc.dev/druva/apis/insync-cloud.md) - [All operations](https://skmtc.dev/druva/apis/insync-cloud/llms.txt) - [OpenAPI document](https://skmtc.dev/druva/apis/insync-cloud/revisions/a0ce6d05033c?raw)
