Data Export Version 3

👍Pro Integration

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 grace_period_end_time.
  • 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
rc_original_app_user_id		Can be used as a unique user identifier to find all of a user's transactions.
rc_last_seen_app_user_id_alias		Can be used together with rc_original_app_user_id to match transactions with user identifiers in your systems.
country	✅	Last seen country of the subscriber.
product_identifier		The product identifier that was purchased.
start_time		Purchase time of transaction.
end_time	✅	Expected expiration time of subscription. Null when is_auto_renewable = false. For Google Play, end_time can be before start_time to indicate an invalid transaction (e.g. billing issue).
grace_period_end_time*	✅	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.
effective_end_time*	✅	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.
store		The source of the transaction. Can be app_store, play_store, stripe, or promotional.
is_auto_renewable		true for auto-renewable subscriptions, false otherwise.
is_trial_period		true if the transaction was a trial.
is_in_intro_offer_period		true if the transaction is in an introductory offer period.
is_sandbox		true for transactions made in a sandbox environment.
price_in_usd	✅	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.
takehome_percentage		[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 tax_percentage and commission_percentage to calculate proceeds instead. Learn more here.
tax_percentage*		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.
commission_percentage*		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.
store_transaction_id		orderId or transaction_identifier.
original_store_transaction_id		orderId of first purchase or original_transaction_id. Can be used to find all related transactions for a single subscription.
refunded_at	✅	When a refund was detected, null if none was detected. Can be checked for existence to indicate transactions which have been refunded.
unsubscribe_detected_at	✅	When we detected an unsubscribe (opt-out of auto renew).
billing_issues_detected_at	✅	When we detected billing issues, null if none was detected.
purchased_currency	✅	The currency that was used for the transaction.
price_in_purchased_currency	✅	The product's price in the currency that was used for the transaction.
entitlement_identifiers	✅	An array of entitlements that the transaction unlocked or null if it didn't unlock any entitlements.
renewal_number		Always starts at 1. Trial conversions are counted as renewals. is_trial_conversion is used to signify whether a transaction was a trial conversion.
is_trial_conversion		If true, this transaction is a trial conversion.
presented_offering	✅	The offering presented to users. Can be used to filter Experiment transactions.
ownership_type*	✅	Will be PURCHASED when a recorded transaction results from the subscriber’s direct purchase of it, or FAMILY_SHARED when a recorded transaction results from the subscriber having received it through Family Sharing. NOTE: The FAMILY_SHARED designation is only supported on App Store transactions.
reserved_subscriber_attributes	✅	The reserved attributes set for the Customer (subscriber). Keys begin with $.
custom_subscriber_attributes	✅	The custom attributes set for the Customer (subscriber).
platform	✅	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.