We're excited to introduce a major update to credit tracking: Credit usage breakdown by dimensions of reported usage events. 

You can now slice-and-dice credit consumption history using the custom dimensions attached to your usage events - such as user ID, workspace ID, LLM model type, and more - giving you and your customers unprecedented visibility into how credits are spent.

🆕 What’s new?

Previously, Stigg only allowed you to view credit usage history at the feature level (i.e., which feature drew down from the credit pool).

With this update, you can drill down into the granular event attributes behind those feature drawdowns. Furthermore, you can break down consumption by multiple dimensions simultaneously - for instance, grouping usage by both Feature ID and User ID to see exactly which team member consumed the most credits on a specific feature.

To ensure performance remains lightning-fast even with high volumes of granular data, all breakdown results are fully paginated.

⭐️ Why it matters

• End-Customer Transparency: Build trust by showing your customers exactly who or what is driving up their bill (e.g., "User A spent 400 credits on gpt-4o queries").
• Internal Troubleshooting & BI: Equips your customer success and engineering teams with the granular data needed to debug unexpected usage spikes or run deep business intelligence analyses on credit utilization.

🍿 See it in action

Via the Stigg API & SDKs - You can request dimension-based breakdowns programmatically. Simply pass the groupBy array in your credit usage history queries.

In the Stigg App - when viewing a customer's credit pool in the Stigg dashboard, you can now toggle custom dimension filters to instantly generate usage charts and breakdown tables based on your custom event metadata:

📦 Availability

Credit usage breakdown by event dimensions is available immediately for all customers. You can access it directly within the Stigg app UI or query it programmatically via the latest versions of the Stigg API and SDKs:

REST-based SDKs

• TypeScript: v0.1.0-beta.15
• Python: v0.1.0-beta.13
• Go: v0.1.0-beta.15
• Java: v0.1.0-beta.13
• Ruby: v0.1.0-beta.15

GraphQL-based SDKs

• Node.js: v4.43.0
• Python: v6.11.0
• Go: v6.11.0
• Java: v6.11.0
• .NET: v6.11.0
• Ruby: v6.9.0