| title | Overview of metered APIs and services in Microsoft Graph |
|---|---|
| description | Get an introduction to metered APIs and services in Microsoft Graph. |
| author | spgraph-docs-team |
| ms.localizationpriority | high |
| ms.custom | scenarios:getting-started |
| ms.date | 11/07/2024 |
| ms.topic | concept-article |
Microsoft Graph includes APIs that are available at no additional cost with user subscription licenses and APIs and services that are metered. Metered APIs and services in Microsoft Graph incur costs based on usage. The costs might be incurred per API call made, per object returned in an API call, or through other measures.
Whether metered or not, APIs in Microsoft Graph follow these two principles:
- Customer data ownership: Customer data belongs to the customer. Learn more about how Microsoft categorizes customer data.
- Reasonable access: The service provides access to customer content, within defined limits.
Metering some APIs helps to ensure the health of the current and future Microsoft Graph ecosystem by balancing platform access and cost. In the event that a Microsoft Graph API that is included with user subscription licenses becomes metered, that would be a non-backward compatible change and the versioning, support, and breaking change policies for Microsoft Graph would apply.
For the list of metered APIs and services, see Metered APIs and services.
Microsoft Graph APIs fall into three categories, and metering might apply based on the category of the API.
Most Microsoft Graph APIs are standard APIs. These APIs perform standard operations (create, read, update, delete) on customer content and administrative endpoints. Reasonable access limits for these APIs are defined based on documented usage thresholds. This helps to ensure a positive customer experience and encourages efficient API usage patterns. Access to standard APIs within the defined usage thresholds is available as part of the user license without additional costs.
High-capacity APIs ensure that customers and developers have access to data at scale. This category includes purpose-built, bulk export or import endpoints and Microsoft Graph services. These APIs might be metered and incur additional costs beyond user subscription licenses.
Advanced APIs provide access to enriched or aggregated data, or advanced functionality that extends from Microsoft 365. The assignSensitivityLabel API is an example of an advanced API. These APIs might be metered and incur additional costs beyond user subscription licenses.
To access metered APIs and services in Microsoft Graph, an application must be associated with an active Microsoft Azure subscription. For details about how to associate an app to a subscription, see Enable metered APIs and services in Microsoft Graph.
Keep the following considerations in mind when you use metered APIs and services in Microsoft Graph:
- Metered APIs can return errors related to your subscription status in addition to other common errors. For details about Microsoft Graph errors, see Microsoft Graph errors and resource types.
- Metered APIs are billed according to API usage. Be sure to understand the metering unit so that you can estimate the costs associated with a particular API.
[!INCLUDE Metered API Known Limitations]