Scheduled data exports are available to all users signed up after September '23, the legacy Grow and Pro plans, and Enterprise plans. If you're on a legacy Free or Starter plan and want to access this integration, migrate to our new pricing via your [billing settings](🔗).
# Version 3 Change Log
### Expiration fields
grace_period_end_time` allows you to distinguish between a subscriber's expected renewal date (`
end_time`), and their new expiration date if they've been granted a grace period
effective_end_time` represents the date a subscriber will lose access to their entitlement if a successful payment does not occur. It is the latest value of `
end_time` and `
This field should be used to represent a subscriber's expiration date when modeling common RevenueCat measures like Active Subscriptions.
### Taxes, commission, and proceeds estimation
tax_percentage` represents the estimated portion of a transaction's total revenue that will be deducted from the purchasing store due to taxes. To learn more about RevenueCat's tax estimations, [click here](🔗).
commission_percentage` represents the portion of a transaction's total revenue that will be deducted from the purchasing store due to their commissions and fees.
commission_percentage` may differ from the rate expected from the store (e.g. 30%) in cases where taxes are deducted by the store before commission is applied.
### Ownership type
ownership_type` can be used to distinguish between transactions that originated from family sharing and those that did not. RevenueCat excludes family sharing transactions from our measures in Charts.
# Full export format
All dates and times are provided in UTC.
|Header||Can be null||Comments|
|`||||Can be used as a unique user identifier to find all of a user's transactions.|
|`||||Can be used together with `|
|`||✅||Last seen country of the subscriber.|
|`||||The product identifier that was purchased.|
|`||||Purchase time of transaction.|
|`||✅||Expected expiration time of subscription. Null when `|
|`||✅||Expiration time of a grace period (if applicable) for a subscription. Will remain set while a subscription is in its grace period, or if it exited its grace period without renewing. Null when a subscription is not in a grace period or expiration was not due to a grace period.|
|`||✅||Single reference point of a subscriber’s expiration and entitlement revocation; inclusive of each store’s logic for refunds, grace periods, cancellations (if one results in entitlement revocation), etc.|
|`||||The source of the transaction. Can be `|
|`||✅||The gross revenue generated from the transaction. All prices are converted to USD. Can be null if product prices haven't been collected from the user's device.|
|`||||[DEPRECATED] The estimated percentage of the transaction price that will be paid out to developers after commissions, but before VAT and DST taxes are taken into account. (will be either 0.7 or 0.85)
We recommend using `|
|`||||The portion of a transaction’s price that will be deducted by the store for taxes. VAT & Digital Services Taxes may be withheld by stores depending on the store and country. To learn more about how RevenueCat estimates taxes, [click here](🔗).|
|`||||The portion of a transaction’s price that will be detected by the store for commission. In stores where taxes are deducted before commission, this value will not equal the published commission from a store, because that commission is calculated on the post-tax revenue.|
|`||||orderId or transaction_identifier. **Can be used as unique id**.|
|`||||orderId of first purchase or `|
|`||✅||When a refund was detected, `|
|`||✅||When we detected an unsubscribe (opt-out of auto renew).|
|`||✅||When we detected billing issues, `|
|`||✅||The currency that was used for the transaction.|
|`||✅||The product's price in the currency that was used for the transaction.|
|`||✅||An array of entitlements that the transaction unlocked or `|
|`||||Always starts at 1. Trial conversions are counted as renewals. `|
|`||✅||The offering presented to users. Can be used to filter [Experiment](🔗) transactions.|
|`||✅||Will be `|
|`||✅||The [reserved subscriber attributes](🔗) set for the subscriber. Keys begin with `|
|`||✅||The custom attributes set for the subscriber.|
|`||✅||Last seen platform of the subscriber.|
\*Newly added fields for Version 3
To learn more about how to use our transaction data, or get started with sample queries, [click here](🔗).