recentSubscriptionStartDate
The earliest start date of a subscription in a series of auto-renewable subscription purchases that ignores all lapses of paid service shorter than 60 days.
Declaration
timestamp recentSubscriptionStartDateMentioned in
Discussion
The recent subscription start date is in UNIX time, in milliseconds.
Use the recentSubscriptionStartDate to identify the earliest start date of a subscription in a series of auto-renewable subscription purchases that the customer maintained continuously, or that has one or more gaps of less than 60 days each.
The App Store calculates the recentSubscriptionStartDate by finding the start date of the most recent auto-renewable subscription purchase that’s preceded by a gap in paid service of more than 60 days in the production environment, or 10 minutes in the sandbox environment. The start date includes any free trials or promotional purchases. If no such gap exists — for example, if the user has only ever purchased one subscription — the recentSubscriptionStartDate is the same as the subscription’s originalPurchaseDate.
The recentSubscriptionStartDate calculation counts a grace period or a billing retry state as a gap in the paid service.
This date applies to active or expired subscriptions. For example, if a subscriber purchases an auto-renewable subscription on June 1, 2022 and lets it expire on December 31, 2022, the App Store determines the recent subscription start date as follows:
Initially, the recentSubscriptionStartDate is the same as the originalPurchaseDate: June 1, 2022.
If the customer purchases the subscription again on February 1, 2023, less than 60 days after the initial subscription expired, the recentSubscriptionStartDate remains June 1, 2022.
If the customer purchases the subscription again on April 1, 2023, more than 60 days after the first subscription expired, the App Store updates the recentSubscriptionStartDate to April 1, 2023.