Timeline information for a subscription, including billing dates and payment status.
billingDateThe end date for the current billing period, regardless of subscription status. Automatic retries on past due subscriptions do not change the start and end dates of the current billing period.
billingDateThe start date for the current billing period, regardless of subscription status. Automatic retries on past due subscriptions do not change the start and end dates of the current billing period.
createdTimestampThe date and time when the subscription was created.
firstDate!Non-nullThe date when the subscription first started billing. For pending subscriptions with a future start date, this will be a future date.
nextDate!Non-nullThe date when the system will attempt to bill the subscription again. For pending subscriptions that have not yet started, this equals firstBillingDate. This date adjusts automatically with each billing attempt. For past due subscriptions with automatic retry enabled, this date will advance based on your configured retry settings.
paidDateThe date through which the subscription has been paid. It is the billingPeriodEndDate at the time of the last successful transaction. If the subscription is pending (has a future start date), this field is null.
updatedTimestampThe date and time when the subscription was last updated.
type RecurringBillingSubscriptionTimeline {
firstBillingDate: Date!
nextBillingDate: Date!
billingPeriodStartDate: Date
billingPeriodEndDate: Date
paidThroughDate: Date
createdAt: Timestamp
updatedAt: Timestamp
}