> ## 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.

# Python

<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.27" description="2026-06-25">
  **Credit wallet soft limit**

  * Added: `has_soft_limit` 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 `has_access: True` and `has_soft_limit: True` even after the credit balance reaches zero. Hard limit (the default) continues to return `has_access: 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: `group_by` 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.31" description="2026-05-10">
  **Credit usage date filters**

  * Added: `start_date` and `end_date` 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 for the API
</Update>

<Update label="0.1.0-alpha.3" description="2026-01-28">
  * Multiple API updates implemented
</Update>

<Update label="0.1.0-alpha.2" description="2026-01-27">
  * API updates
  * Commented out promotional endpoints
  * Improved cursor pagination functionality
</Update>

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

  * Added customer endpoints
  * Support for binary request streaming
  * Support for file upload requests
  * Environment cleanup improvements

  **Bug Fixes:**

  * Don't send Content-Type header on GET requests
  * Python 3.14 compatibility
  * Pydantic v1 signature updates
  * Stream closure handling
  * Nested discriminated union parsing
  * Empty metadata handling

  **Chores:**

  * Python 3.14 support added
  * Python 3.8 support dropped
  * Python 3.13 marked as supported
  * Dependency updates and internal codegen improvements
</Update>