Skip to main content
​
2026-07-08
Direct credit consumption
  • Added: consumeCredits (synchronous) and consumeCreditsAsync (asynchronous) methods to deduct credits directly from a customer’s pool, without reporting usage against a metered feature or requiring an active subscription. Use consumeCredits for strict, real-time enforcement; use consumeCreditsAsync for high-volume, eventually-consistent consumption. See direct credit consumption.
  • getCreditEntitlement and getEntitlement continue to return a valid credit balance for customers with no active subscription, so credit governance can run fully decoupled from Stigg subscription management.
​
2026-06-23
Synchronous credit balance updates via reportUsage
  • Added: When reportUsage is called for a credit-backed feature, the response now includes a credit object with the updated credit balance — immediately, before the asynchronous metering pipeline settles. credit contains currencyId, currentUsage, usageLimit, and timestamp. Use reportUsage for sub-second, strict credit enforcement; use reportEvent for high-volume, eventually-consistent metering.
Credit wallet soft limit
  • Added: hasSoftLimit field on credit entitlement responses. When a credit entitlement is configured as a soft limit, getEntitlement returns isGranted: true and hasSoftLimit: true even after the credit balance reaches zero. Credit-backed features inherit the wallet’s soft-limit so dependent feature reads stay consistent.
​
2026-06-01
Credit usage breakdown by event dimensions
  • Added: groupBy array parameter on getCreditUsage 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.
​
2026-05-10
Credit usage date filters
  • Added: startDate and endDate parameters on getCreditUsage. 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.
​
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.
​
2026-04-29
  • Added: includeInactiveSubscriptions parameter on getUsageHistoryV2. When set to true, usage history is returned regardless of whether the customer currently has an active subscription. If they do have an active subscription, the response also includes a markers array containing the subscription’s usage reset timestamps.
​
2026-03-17
  • Added: getCreditEntitlement() method for low-latency retrieval of customer credit balance from the local cache.
  • Added: Support for provisioning subscriptions with variable recurring credit grant entitlements.
​
2026-01-24
  • Added: Support for configuring and managing credit auto-recharge settings, including trigger balance, target top-up amount, and monthly spend limit.
​
2025-11
This major version reflects a monorepo-wide version increment driven by a breaking change in the Python SDK (pydantic v1 → v2 dependency update). There are no breaking changes for the Java SDK in this version.
​
2025-11-02
This major version reflects a monorepo-wide version increment driven by breaking changes in the Node.js and Sidecar SDKs (entitlements retrieval logic). There are no breaking changes for the Java SDK in this version.
​
2025-09-29
  • Added getCreditLedger and getCreditUsage methods.
​
2025-09-29
  • Added void credit grant voidCreditGrant.
​
2025-09-29
  • Added credit balance subscription handling with automatic entitlement updates, expiration checks, and cache mapping for credit rate and validity.
​
2025-09-25
  • Added credit rate mapping.
​
2025-09-23
  • Added awsMarketplaceCustomerId to update and provision customers.
​
2025-09-04
  • Added: grantPromotionalEntitlementsGroup or granting a promotional entitlements group - all entitlements that are not already granted to a customer, need to be included in the request.
  • Added: revokePromotionalEntitlementsGroup for revoking all of the entitlements of a group, unless they are a part of a different group.
  • Added: unlinkPromotionalEntitlementsGroup for removing the references of the group from promotional entitlements that are a part of it, while keep granting access to those entitlements.
​
2025-09-03
  • Added support for subscriptions filter by resourceId and plan (planId/displayName).
​
2025-09-02
  • Added: CancelSubscription.awaitSubscriptionCancellation for controlling whether to wait for confirmation from billing solutions that are integrated with Stigg before marking subscription as canceled in Stigg
​
2025-08-15
  • Added: SubscriptionBillingInfo.prorationBehavior for controlling the proration behavior when provisioning and updating subscriptions. The new parameter accepts the following value
  • CREATE_PRORATIONS - bill for proration immediately. This is the default behavior.
  • INVOICE_IMMEDIATELY - include prorated charges in the upcoming invoice.
  • NONE - don’t prorate subscription changes.
​
2025-06-26
  • Added: getSubscriptions endpoint that allows retrieving all of customers’ subscriptions
​
2025-02-23
  • Added: SubscriptionFragmentLatestInvoice.attemptCount
​
2025-01-21
  • Added: ImportSubscriptionInput.subscriptionId
​
2025-01-19
  • Added: importSubscriptionInput.salesforceId, importCustomerInput.salesforceId
​
2024-12-17
  • Added: GetUsageHistoryV2
  • ⚠️ Deprecated: GetUsageHistory(please use GetUsageHistoryV2 instead)
  • Changed:
    • Input Object:
      • customerRefId renamed to customerId
      • resourceRefId renamed to resourceId
      • featureRefId renamed to featureId
      • resetPeriod removed
      • yearlyResetPeriodConfiguration removed
      • monthlyResetPeriodConfiguration removed
      • weeklyResetPeriodConfiguration removed
    • Output Object
      • startDate removed
      • endDate removed
      • usageMeasurements[i].date renamed to series[0].point[i].timestamp
      • usageMeasurements[i].value renamed to series[0].point[i].value
      • usageMeasurements[i].isResetPoint renamed to series[0].point[i].isResetPoint
        • Old Value: true if and only if usage was reset due to periodic reset.
        • New Value: true if and only if usage was reset due to periodic reset or due to a plan transition.
      • groups[i].groupInfo[j].key renamed to series[i].tags[j].key
      • groups[i].groupInfo[j].value renamed to series[i].tags[j].value
      • groups[i].usageMeasurements[j].date renamed to series[i].point[j].timestamp
      • groups[i].usageMeasurements[j].value renamed to series[i].point[j].value
      • groups[i].usageMeasurements[j].isResetPoint renamed to series[i].point[j].isResetPoint
        • Old Value: true if and only if usage was reset due to periodic reset.
        • New Value: true if and only if usage was reset due to periodic reset or due to a plan transition.
​
2024-12-15
  • Added: getActiveSubscriptionsList_trialConfiguration and getActiveSubscriptionsList_trialConfiguration_trialEndDate
​
2024-12-08
  • Added: ability to override prices when there’s a scheduled update in place
​
2024-12-3
  • Added: TrialConfiguration to getActiveSubscriptions()
​
2024-12-02
  • Added: validation that coupon name does not exceed 40 characters
​
2024-12-02
  • Added: SubscriptionCoupon.amountsOff
  • Added: SubscriptionCoupon.description
  • Added: SubscriptionCoupon.durationInMonths
  • Added: SubscriptionCoupon.name
  • Added: SubscriptionCoupon.percentOff
​
2024-12-01
  • Added: EstimateSubscriptionInput.TrialOverrideConfigurationInput.trialEndBehavior
  • Added: PreviewSubscriptionInput.TrialOverrideConfigurationInput.trialEndBehavior
​
2024-11-24
  • Added: EstimateSubscriptionInput.TrialOverrideConfigurationInput.trialEndDate
  • Added: PreviewSubscriptionInput.TrialOverrideConfigurationInput.trialEndDate
​
2024-11-21
  • Added: support for price localization in fixed fee coupons
​
2024-11-18
  • Added: Ability to remove customer’s email address by passing an empty string on updateCustomer.email
​
2024-11-18
  • Added: DelegateSubscriptionToCustomer()
  • Added: TransferSubscriptionToResource()
  • ⚠️ Deprecated: TransferSubscriptin() method (please use TransferSubscriptionToResource() instead)
​
2024-11-05
  • Added: UsageHistoryFragment.Markersto reflect information about the reset usage dates
​
2024-11-04
  • Fixed: issue where customer.discount.deleted event from Stripe isn’t handled properly
​
2024-11-05
  • Added: Edge support for GetActiveSubscriptionsListQuery
​
2024-10-31
  • Added: ability to set any date in the SubscriptionFragment.trial_end_date
​
2024-10-13
  • Added: ability to estimate the subscription cost when the payment of the subscription is delegated to a different customer using:
    • ProvisionSubscriptionInput.payingCustomerId
    • UpdateSubscriptionInput.payingCustomerId
    • ApplySubscriptionInput.payingCustomerId
    • PreviewSubscriptionInput.payingCustomerId
    • EstimateSubscriptionInput.payingCustomerId
    • EstimateSubscriptionUpdateInput.payingCustomerId
​
2024-10-13
  • Added: throw error when sync to Stripe fails due to unrecognized customer billing address
​
2024-10-06
  • Added: ability to more easily determine the usage period of metered entitlements using:
    • Entitlement.usagePeriodStart
    • Entitlement.usagePeriodEnd
  • ⚠️ Deprecated: Entitlement.nextResetDate field
​
2024-09-19
  • Added: throw error when attempting to import a customer with an existing billingId
​
2024-09-17
  • Added: CustomerPortalSubscriptionFragment.planId
​
2024-09-11
  • Added: SubscriptionCouponInput.billingCouponId
  • ⚠️ Deprecated: ProvisionSubscriptionInput.promotionCode
  • ⚠️ Deprecated: UpdateSubscriptionInput.promotionCode
  • ⚠️ Deprecated: ApplySubscriptionInput.promotionCode
  • ⚠️ Deprecated: PreviewSubscriptionInput.promotionCode
  • ⚠️ Deprecated: EstimateSubscriptionInput.promotionCode
  • ⚠️ Deprecated: EstimateSubscriptionUpdateInput.promotionCode
​
2024-09-01
  • Added: ability to delegate payment of a provisioned subscription to a different customer using:
    • ProvisionSubscriptionInput.payingCustomerId
    • ApplySubscriptionInput.payingCustomerId
    • SlimSubscriptionFragmentV2.payingCustomer
    • FullSubscription.payingCustomer
​
2024-08-22
  • Added: ability to apply a coupon to a subscription using the Stigg coupon ID using:
    • ProvisionSubscriptionInput.appliedCoupon
    • UpdateSubscriptionInput.appliedCoupon
    • ApplySubscriptionInput.appliedCoupon
    • PreviewSubscriptionInput.appliedCoupon
    • EstimateSubscriptionInput.appliedCoupon
    • EstimateSubscriptionUpdateInput.appliedCoupon
​
2024-08-20
  • Changed: ImportCustomerBulk changed to ImportCustomerBulkInput
​
2024-08-07
  • Added: ability to undo subscription scheduled cancelation using CancelSubscriptionUpdates()
​
2024-08-07
  • Added: ability to preview a subscription’s upcoming invoice using PreviewNextInvoice()
​
2024-07-07
  • Changed: GetUsageHistory() now returns the precise timestamp when the usage was reset
​
2024-07-01
  • Changed: UpdateSubscriptionInput.subscriptionEntitlements does not require the full list of entitlements when needing to add or update specific entitlements
​
2024-06-27
  • Added: TrialOverrideConfigurationInput.trialEndDate to allow scheduled trial cancelation when provisioning and updating subscriptions
​
2024-06-20
  • Added: ability to get the list of active subscriptions from Edge using GetActiveSubscriptionsList()
​
2024-06-16
  • Added: ability to get the list of active subscriptions using GetActiveSubscriptions()
​
2024-01-22
🛑 Breaking change
  • Changed: For Volume/tiered pricing, unitPrice was moved to flatPrice.