{
"type": "subscription.billing_month.ends_soon",
"messageId": "a6ce...",
"traceId": "549a...",
"entityId": "subscription-uuid",
"id": "subscription-id",
"status": "ACTIVE",
"paymentCollection": "NOT_REQUIRED",
"startDate": "2023-06-10T11:22:33.001Z",
"currentBillingMonthStart": "2024-10-10T11:22:33.001Z",
"currentBillingMonthEnd": "2024-11-10T11:22:33.001Z",
"currentBillingPeriodStart": "2024-06-10T11:22:33.001Z",
"currentBillingPeriodEnd": "2025-06-10T11:22:33.001Z",
"billingPeriod": "ANNUALLY",
"billingCurrency": "ils",
"entitlements": [
{
"feature": {
"id": "feature-01-stores",
"name": "Stores",
"description": "",
"unit": "Store",
"units": "Stores"
},
"usageLimit": 5,
"currentUsage": 3,
"usagePeriodAnchor": null,
"usagePeriodStart": null,
"usagePeriodEnd": null,
"resetPeriod": null
}
]
}
Fired 1 hour before the subscription’s billing month ends (monthly cadence for both monthly/annual). Use it for smart, usage-aware upgrade prompts before monthly anchor resets.
{
"type": "subscription.billing_month.ends_soon",
"messageId": "a6ce...",
"traceId": "549a...",
"entityId": "subscription-uuid",
"id": "subscription-id",
"status": "ACTIVE",
"paymentCollection": "NOT_REQUIRED",
"startDate": "2023-06-10T11:22:33.001Z",
"currentBillingMonthStart": "2024-10-10T11:22:33.001Z",
"currentBillingMonthEnd": "2024-11-10T11:22:33.001Z",
"currentBillingPeriodStart": "2024-06-10T11:22:33.001Z",
"currentBillingPeriodEnd": "2025-06-10T11:22:33.001Z",
"billingPeriod": "ANNUALLY",
"billingCurrency": "ils",
"entitlements": [
{
"feature": {
"id": "feature-01-stores",
"name": "Stores",
"description": "",
"unit": "Store",
"units": "Stores"
},
"usageLimit": 5,
"currentUsage": 3,
"usagePeriodAnchor": null,
"usagePeriodStart": null,
"usagePeriodEnd": null,
"resetPeriod": null
}
]
}
Minimal subscription object embedded in events.