Sample code for 30+ languages & platforms
React Native

Outlook -- Search Multiple Folders

See more Outlook Examples

I don't yet see how it's possible to do a recursive search of Outlook folders using the Microsoft Graph API. My best guess is to somehow use OData v4.0's $expand query option, but the hierarchical structure of the "mailFolder" and "messages" Microsoft Graph resources don't quite fit. Suggestions are welcome and can be sent to support@chilkatsoft.com.

This example will iterate over a list of folder previously obtained by a recursive traversal of the Outlook mail folders. (See the link in the example code below.)

A separate search is performed on each desired folder, and the results are combined into a single result set.

Note: This example requires Chilkat v9.5.0.68 or greater.

This example applies to: Exchange Online | Office 365 | Hotmail.com | Live.com | MSN.com | Outlook.com | Passport.com

Chilkat React Native Downloads

React Native
import { Http, JsonObject, StringBuilder, Xml } from '@chilkat/react-native'

async function chilkatExample() {
  let success = false;

  // This example requires the Chilkat API to have been previously unlocked.
  // See Global Unlock Sample for sample code.

  const http = new Http();

  // Use your previously obtained access token here:
  // See the following examples for getting an access token:
  //    Get Microsoft Graph OAuth2 Access Token (Azure AD v2.0 Endpoint).
  //    Get Microsoft Graph OAuth2 Access Token (Azure AD Endpoint).
  //    Refresh Access Token (Azure AD v2.0 Endpoint).
  //    Refresh Access Token (Azure AD Endpoint).

  http.authToken = 'MICROSOFT_GRAPH_ACCESS_TOKEN';

  // This example will iterate over the folders previously discovered by recursively traversing the Outlook folders
  // as shown in this example:  Outlook Recursive Folder Traversal)

  // The XML map produced by the recursive traversal looks like this:

  // 	<?xml version="1.0" encoding="utf-8"?>
  // 	<hashtable>
  // 	<e><k>/Sent Items</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEJAAAA</v></e>
  // 	<e><k>/Inbox</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA</v></e>
  // 	<e><k>/Junk Email</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEiAAAA</v></e>
  // 	<e><k>/Inbox/xyz</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwEAAAA=</v></e>
  // 	<e><k>/Inbox/abc/subFolderA/a</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwIAAAA=</v></e>
  // 	<e><k>/Inbox/abc</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAAA=</v></e>
  // 	<e><k>/Outbox</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgELAAAA</v></e>
  // 	<e><k>/Inbox/abc/subFolderA</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwAAAQ==</v></e>
  // 	<e><k>/Inbox/abc/subFolderB</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwMAAAA=</v></e>
  // 	<e><k>/Archive</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAG8XunwAAAA=</v></e>
  // 	<e><k>/Deleted Items</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEKAAAA</v></e>
  // 	<e><k>/Drafts</k><v>AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEPAAAA</v></e>
  // 	</hashtable>

  // We'll iterate over the folders, and search all folders beginning with "/Inbox" (effectively, we're recursively searching
  // everything under Inbox)
  const xmlMap = new Xml();
  success = true;
  try {
    xmlMap.loadXmlFile('qa_data/outlook/folderMap.xml');
  } catch {
    success = false;
  }
  if (!success) {
    console.log('Failed to load XML folder map.');
    return;
  }

  // We're going to return just the message id, subject, and FROM name/address.
  http.setUrlVar('select', 'id,subject,from');

  // Our search will be for emails with the word "sample" in the subject.
  http.setUrlVar('filter', 'contains(subject,\'sample\')');

  const json = new JsonObject();
  json.emitCompact = false;

  const jsonCombined = new JsonObject();
  jsonCombined.emitCompact = false;

  const sbResponse = new StringBuilder();
  const sbPath = new StringBuilder();
  const numFolders = xmlMap.numChildren;
  let i = 0;
  let j = 0;
  let k = 0;
  while (i < numFolders) {
    xmlMap.i = i;
    sbPath.setString(xmlMap.getChildContent('e[i]|k'));

    if (sbPath.startsWith('/Inbox', true)) {

      console.log('------------------------------------------------------------------');
      console.log(`Searching ${sbPath.getAsString()}`);

      // Search this mail folder..
      http.setUrlVar('folder_id', xmlMap.getChildContent('e[i]|v'));

      sbResponse.clear();
      success = true;
      try {
        await http.quickGetSbAsync('https://graph.microsoft.com/v1.0/me/mailFolders/{$folder_id}/messages?$filter={$filter}&$select={$select}', sbResponse);
      } catch {
        success = false;
      }
      if ((!success) && (http.lastStatus === 0)) {
        console.log(http.lastErrorText);
        return;
      }

      json.loadSb(sbResponse);

      if (http.lastStatus !== 200) {
        console.log(`HTTP response status = ${http.lastStatus}`);
        console.log(json.emit());
        console.log('Failed.');
        return;
      }

      console.log(json.emit());

      // Each mail folder search will return JSON with a value array, which is non-empty if any matching messages were found:

      // 			{
      // 			  "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA')/messages(id,subject,from)",
      // 			  "value": [
      // 				Individual messages, if any, are listed here.
      // 			  ]
      // 			}

      const numMessages = json.sizeOfArray('value');
      j = 0;
      while (j < numMessages) {
        json.j = j;

        // Add this message to the final result set.
        jsonCombined.k = k;
        jsonCombined.updateString('value[k].folderPath', sbPath.getAsString());
        jsonCombined.updateString('value[k].id', json.stringOf('value[j].id'));
        jsonCombined.updateString('value[k].subject', json.stringOf('value[j].subject'));
        jsonCombined.updateString('value[k].from.emailAddress.name', json.stringOf('value[j].from.emailAddress.name'));
        jsonCombined.updateString('value[k].from.emailAddress.address', json.stringOf('value[j].from.emailAddress.address'));
        k++;

        j++;
      }
    }

    i++;
  }

  // Show the final combined JSON search result.
  console.log('------------------------------------------------------------------');
  console.log('Combined Search Results:');
  console.log(jsonCombined.emit());

  // Sample output for the above program:

  // ------------------------------------------------------------------
  // Searching /Inbox
  // {
  //   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA')/messages(id,subject,from)",
  //   "value": [
  //     {
  //       "@odata.etag": "W/\"CQAAABYAAADn68XtMop0TpsYJGpfKXY9AADOpwfr\"",
  //       "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA5_vF7TKKdE6bGCRqXyl2PQAAAM6Jj10AAAA=",
  //       "subject": "A sample email with Amazon in the body",
  //       "from": {
  //         "emailAddress": {
  //           "name": "Chilkat Software",
  //           "address": "support@chilkatsoft.com"
  //         }
  //       }
  //     }
  //   ]
  // }
  // 
  // ------------------------------------------------------------------
  // Searching /Inbox/xyz
  // {
  //   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwEAAAA%3D')/messages(id,subject,from)",
  //   "value": [
  //   ]
  // }
  // 
  // ------------------------------------------------------------------
  // Searching /Inbox/abc/subFolderA/a
  // {
  //   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwIAAAA%3D')/messages(id,subject,from)",
  //   "value": [
  //     {
  //       "@odata.etag": "W/\"CQAAABYAAADn68XtMop0TpsYJGpfKXY9AADOpzfb\"",
  //       "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwIAAADn68XtMop0TpsYJGpfKXY9AAAAzombFQAAAA==",
  //       "subject": "Sample email from admin@chilkat.io",
  //       "from": {
  //         "emailAddress": {
  //           "name": "Chilkat Software",
  //           "address": "admin@chilkat.io"
  //         }
  //       }
  //     }
  //   ]
  // }
  // 
  // ------------------------------------------------------------------
  // Searching /Inbox/abc
  // {
  //   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huv8AAAA%3D')/messages(id,subject,from)",
  //   "value": [
  //   ]
  // }
  // 
  // ------------------------------------------------------------------
  // Searching /Inbox/abc/subFolderA
  // {
  //   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwAAAQ%3D%3D')/messages(id,subject,from)",
  //   "value": [
  //   ]
  // }
  // 
  // ------------------------------------------------------------------
  // Searching /Inbox/abc/subFolderB
  // {
  //   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('me')/mailFolders('AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgAuAAADsVyfxjDU406Ic4X7ill8xAEA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwMAAAA%3D')/messages(id,subject,from)",
  //   "value": [
  //   ]
  // }
  // 
  // ------------------------------------------------------------------
  // Combined Search Results:
  // {
  //   "value": [
  //     {
  //       "folderPath": "/Inbox",
  //       "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAgEMAAAA5_vF7TKKdE6bGCRqXyl2PQAAAM6Jj10AAAA=",
  //       "subject": "A sample email with Amazon in the body",
  //       "from": {
  //         "emailAddress": {
  //           "name": "Chilkat Software",
  //           "address": "support@chilkatsoft.com"
  //         }
  //       }
  //     },
  //     {
  //       "folderPath": "/Inbox/abc/subFolderA/a",
  //       "id": "AQMkADAwATM0MDAAMS1iNTcwLWI2NTEtMDACLTAwCgBGAAADsVyfxjDU406Ic4X7ill8xAcA5_vF7TKKdE6bGCRqXyl2PQAAAL8huwIAAADn68XtMop0TpsYJGpfKXY9AAAAzombFQAAAA==",
  //       "subject": "Sample email from admin@chilkat.io",
  //       "from": {
  //         "emailAddress": {
  //           "name": "Chilkat Software",
  //           "address": "admin@chilkat.io"
  //         }
  //       }
  //     }
  //   ]
  // }
  // 
}