eDiscovery API for Microsoft Graph is now generally available

Microsoft Graph team

We are excited to announce the general availability of the Microsoft Graph APIs for Microsoft Purview eDiscovery (Premium) to help you automate common eDiscovery workflows and integrate third party applications into eDiscovery (Premium).

Why use the Microsoft Graph APIs for Microsoft Purview eDiscovery (Premium) 

In many organizations, eDiscovery workflows are frequent, critical, and high volume. In the cases where there are common repeated tasks or a high volume of activities, the APIs will help provide a scalable way to repeat processes consistently and effectively.


Integrate with 3rd party or in-house legal systems, holds databases or review tools to automate workflows. 


Build applications that enhance the Microsoft Purview eDiscovery (Premium) capabilities. 

For more information, refer to Use the Microsoft Graph eDiscovery API and Manage your eDiscovery workflows. 

License requirements

The following licenses provide the rights to the APIs for eDiscovery (Premium) capabilities: 

  • Microsoft 365 E5/A5 
  • Microsoft 365 E5/A5/F5 Compliance and F5 Security & Compliance 
  • Microsoft 365 E5/A5/F5 eDiscovery and Audit 
  • Microsoft 365 Office E5/A5 

Our Government Cloud customers will have access to APIs for eDiscovery (Premium) later this calendar year. 

The use of the ‘addToReviewSetAPI requires an E5 license (listed above) which provides a seeded capacity without consumption cost until the seeded capacity is reached. Seeded capacity is how much volume an app can consume before having to pay usage fees. Capacity is pooled at the tenant level—the seeded capacity for all users in the tenant is added up and compared against the app’s usage in the tenant. Once the customer exceeds seeded capacity, consumption meters will kick in. Consumption meter charges for the ‘addToReviewSetAPI usage beyond available seeded capacity is planned to commence in CY23. A 90-day notice will be provided before these charges are in effect.

API  Seeded capacity  Price for additional use  Example 
addToReviewSet  1 GB per licensed user per month – pooled at the tenant level  $15 per GB  An organization with 10,000 E5 licenses will get 10,000 GB per month pooled at the tenant level.  

If the organization uses 10,500 GB a month they will be charged $7,500 (500 GB x $15/GB). 

If the organization uses 9500 GB a month, they will not get charged any additional fee for the API usage and there is no carry over of 500 GB to the following month.  

eDiscovery endpoint availability

The following eDiscovery endpoints are in preview and only available in beta. 

Happy coding!


Discussion is closed.

Feedback usabilla icon