> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stigg.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Java

<Update label="0.1.0-beta.31" description="2026-07-08">
  **Direct credit consumption**

  * Added: an endpoint to consume credits directly from a customer's pool, without reporting usage against a metered feature or requiring an active subscription. Complements the existing grant-credits endpoint so credit balances, grants, and consumption can be managed fully decoupled from Stigg subscription management. See [direct credit consumption](/documentation/modeling-your-pricing-in-stigg/credits/credits-core-concepts#direct-credit-consumption).
  * The check-entitlement endpoint continues to return a valid credit balance for customers with no active subscription.
</Update>

<Update label="0.1.0-beta.26" description="2026-06-25">
  **Credit wallet soft limit**

  * Added: `hasSoftLimit` field on check-entitlement responses. When a credit entitlement is configured as a soft limit in the plan or add-on, the check-entitlement endpoint returns `hasAccess: true` and `hasSoftLimit: true` even after the credit balance reaches zero. Hard limit (the default) continues to return `hasAccess: false` when the balance is exhausted. Credit-backed features inherit the wallet's soft-limit so dependent feature reads stay consistent.
</Update>

<Update label="0.1.0-beta.13" description="2026-06-01">
  **Credit usage breakdown by event dimensions**

  * Added: `groupBy` array parameter on the retrieve credit usage endpoint to break down credit consumption by any dimension key attached to reported usage events (e.g., `user`, `model`, `region`). Results are paginated for performance at high event volumes.
</Update>

<Update label="0.1.0-alpha.52" description="2026-05-10">
  **Credit usage date filters**

  * Added: `startDate` and `endDate` parameters on the retrieve credit usage endpoint. Pass specific start and end timestamps to retrieve credit consumption data for an exact time window, in addition to the existing preset period enums. See [customer credits](/documentation/modeling-your-pricing-in-stigg/credits/customer-credits).
</Update>

<Update label="0.1.0-alpha.5" description="2026-03-19">
  * Added: `billingCycleAnchor` property when provisioning and updating subscriptions. Accepts `SubscriptionBillingCycleAnchor.UNCHANGED` (default) to keep the existing billing cycle anchor, or `SubscriptionBillingCycleAnchor.NOW` to reset it to the current timestamp.
</Update>

<Update label="0.1.0-alpha.4" description="2026-01-29">
  * Updated stainless config
</Update>

<Update label="0.1.0-alpha.3" description="2026-01-29">
  * API updates delivered in this release
</Update>

<Update label="0.1.0-alpha.2" description="2026-01-27">
  * Manual updates to the API
</Update>

<Update label="0.1.0-alpha.1" description="2026-01-27">
  **Features:**

  * Added customer endpoints
  * Exception handling for retryable scenarios
  * Improved cursor-based pagination
  * HTTP configuration options and dispatcher customization
  * ProGuard and R8 compatibility enhancements

  **Bug Fixes:**

  * Multi-value header serialization fixes
  * Timezone preservation in date-time parsing

  **Chores:**

  * CI/CD pipeline improvements
  * Documentation updates
  * Extensive API endpoint coverage
</Update>
