v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB

Federated Search

Search for emails

Search for backed-up emails using the email attachments’ SHA1 checksum value and view their details. While using this API, ensure the following:

Make repeated API calls until the next page token is empty
For each response, append the previous search results into the list until the next page token yields empty results
This list is the final search result across the entire dataset

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

get/search/mds/v1/user/emails

Query parameters

attachmentSha1Checksumstring required

Specify the SHA1 value of the email attachment that you want to search. To know how to get SHA1 value of an email, see <a href=https://developer.druva.com/docs/event-apis>Search emails using checksums</a> .

minReceiveTimestring

Filter to list the emails which are received after a particular date and time. Format - YYYY-MM-DDTHH:MM:SSZ

maxReceiveTimestring

Filter to list the emails which are received before a particular date and time. Format - YYYY-MM-DDTHH:MM:SSZ

attachmentTypestring[]

Specify the attachment file extensions by which you intend to filter the email search list.

minAttachmentSizeinteger

Filter to list the emails based on their minimum attachment file size (in bytes). All emails with an attachment file size greater than mentioned value will be listed.

maxAttachmentSizeinteger

Filter to list the emails based on their maximum attachment file size (in bytes). All emails with an attachment file size less than mentioned value will be listed.

dataSourcestring[]

Select a data source from which you want to search and list emails.

userIDinteger[]

Specify the User ID of the user for whom you want to filter and list the email results. Get the ID of a user using the ‘List all users’ API.

pageTokenstring

The token to access the next page of results. Use the token value received in the previous response's parameter nextPageToken.

Response

List of emails.

nextPageTokenstring

The token to access the next page of results. This parameter will be empty for the last page of results.

Example response

{
  "results": [
    {
      "deviceID": 12345,
      "userID": 12345,
      "storageID": 1,
      "attachments": [
        {
          "attachmentName": "abc.txt",
          "attachmentSize": 500,
          "attachmentSha1Checksum": "AQAAAAEAAAAwQDAwMDAxQDAwMDBA"
        }
      ],
      "recieveTime": "2022-07-25T00:00:00Z",
      "messagePath": "Outlook Advanced/john.smith@druva.org/Inbox/Inbox/Druva inSync.eml"
    }
  ]
}