---
title: "Search for files"
method: GET
path: "/search/mds/v1/user/files"
tags: ["Federated Search"]
---

# Search for files

`GET /search/mds/v1/user/files`

Search for backed-up files using the SHA1 checksum value and view their details. 
While using this API, ensure the following: 
1. Make repeated API calls until the next page token is empty 
2. For each response, append the previous search results into the list until the next page token yields empty results 
3. This list is the final search result across the entire dataset 

 Note :
 SaaS Apps such as SharePoint Online and Shared Drive are not supported

## Query parameters

- `sha1Checksum` string, required
- `minCreationTime` string
- `maxCreationTime` string
- `minModificationTime` string
- `maxModificationTime` string
- `fileType` string[]
- `minFileSize` integer
- `maxFileSize` integer
- `dataSource` string[]
- `userID` integer[]
- `pageToken` string

## Response `200`

OK

- object
  - `results` object[]
    - `deviceID` integer — The device ID of the device from which the file is backed up.
    - `userID` integer — The user ID of the user to which the file belongs.
    - `storageID` integer — The storage ID of the storage associated with the user.
    - `sha1Checksum` string — The SHA1 value of the file.
    - `fileName` string — The name of the file.
    - `fileSize` integer — The size of the file in Bytes.
    - `creationTime` string — The date on which the file was created (in UTC timezone).
    - `modificationTime` string — The date on which the file was last updated (in UTC timezone).
    - `folderPath` string — The absolute path of the file on the user device.
    - `objectID` string — The unique identifier of the file to take further action based on the result.
  - `nextPageToken` string — The token to access the next page of results. This parameter will be empty for the last page of results.

## Other responses

- `400` — Bad Request
- `401` — The request did not include an authentication token or an expired authentication token was supplied.
- `403` — Forbidden
- `404` — The requested resource was not found.
- `500` — Internal Server Error

---

[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/revisions/2af2bf148b25/schema)