We've decoupled the retrieval of customer usage history from their subscription lifecycle, giving you continuous and uninterrupted visibility into their activity.

🆕 What’s New

The behavior of the getUsageHistoryV2 endpoint has been extended. You can now retrieve a customer's usage history for a metered feature regardless of whether they currently have an active subscription or had one during the requested time frame.

If the customer does have an active subscription, the endpoint response includes a markers array containing the subscription's usage reset periods.

⭐️ Why It Matters

• Query usage data regardless of the subscription state
• Contextualized data: The markers array allows you to easily cross-reference raw usage data with entitlements, making it crystal clear exactly when a customer's usage was reset.

⚒️ Get Started

• GraphQL API and GraphQL-based SDKs - pass the includeInactiveSubscriptions: true parameter when calling the getUsageHistoryV2 endpoint.
• REST API and REST-based SDKs - simply call the getUsageHistory endpoint.

📦 Availability

GraphQL-based SDKs:

• Node SDK: v4.29.3
• Python / Java / Go / .NET SDKs: v6.2.3
• Ruby: v6.2.3

REST-based SDKs:

All versions