Skip to main content
POST
subscription.trial.ends_soon

Body

application/json

Minimal subscription object embedded in events.

entityId
string | null

Stigg UUID of the subscription entity.

id
string

Subscription identifier in Stigg.

billingId
string | null

Identifier for the subscription in the billing provider.

status
string

Current subscription status (e.g., ACTIVE, PAYMENT_PENDING).

startDate
string<date-time> | null

Subscription start timestamp (ISO 8601).

endDate
string<date-time> | null

Subscription end timestamp if scheduled/ended.

cancellationDate
string<date-time> | null

Effective cancellation timestamp, if canceled.

trialEndDate
string<date-time> | null

Trial end timestamp, if in trial or recently converted.

currentBillingPeriodStart
string<date-time> | null

Start timestamp of the current billing period.

currentBillingPeriodEnd
string<date-time> | null

End timestamp of the current billing period.

billingPeriod
string | null

Billing interval for the plan (e.g., MONTHLY, ANNUALLY).

billingCurrency
string | null

ISO currency code for this subscription’s charges.

isTrialSubscription
boolean | null

Whether the subscription is currently a trial.

paymentCollection
string | null

Whether payment collection is required (e.g., NOT_REQUIRED).

resource
any | null

Resource scoping for the subscription, if resource-based.

plan
object

Minimal plan object embedded in events.

addons
object[]

Add-ons currently attached to the subscription.

metadata
object

Arbitrary key-value metadata attached to the subscription.

isUpgrade
boolean | null

Whether this change represents an upgrade (when present in subscription.* events).

isDowngrade
boolean | null

Whether this change represents a downgrade (when present in subscription.* events).

experimentInfo
object