Shape
What happened during each period
Chart · Revenue
Revenue is the money your app received in a period: subscription purchases and renewals, one-time purchases and ad revenue, minus refunds recorded in that period. RevenueDot converts every amount to US dollars at the exchange rate of the purchase date, leaves out sandbox purchases, and counts free trials as zero.
Formula
Revenue = purchases + renewals + one-time purchases + ad revenue − refunds recorded in the period
Shape
What happened during each period
API name
revenue
Measures
Revenue (USD), Transactions (Count)
Filter and segment by
App, Store, Product, Product duration, Offering, Country, Platform, App version, Media source, Campaign, Ad group, Keyword, Ad, Creative, Renewal Cycle, Offer type
Definition
The chart plots two measures. Revenue adds every paid purchase, renewal and one-time purchase dated in the period, adds the ad revenue the SDK reported, and subtracts refunds on the day they were recorded. A refund recorded in March lowers March, even when the purchase was in February, and a reversed refund adds the money back on the reversal date. Transactions counts paid purchases, renewals and one-time purchases. Refunds do not reduce it, and ad revenue is not a transaction.
A free trial start carries no money, so it adds nothing until the trial converts. RevenueDot leaves out sandbox purchases (the Sandbox data switch, or environment=sandbox in the API, shows only those), promotional access you granted, and Family Sharing purchases. Every amount is converted to US dollars at the exchange rate of the purchase date. Pick another currency, such as currency=EUR, and RevenueDot converts that USD amount at the same date's rate. Periods are UTC: days start at 00:00 UTC and weeks start on Monday.
The revenue_type selector has three options. revenue is gross. revenue_net_of_taxes takes out the tax inside each price: the tax Stripe, Paddle or Google Play reported, else the standard VAT or GST rate of the buyer's country. proceeds then takes the store commission from what is left. You can filter or segment by app, store, product, product duration, offering, country, platform and app version, at day, week, month, quarter or year resolution.
Find it in the dashboard under Analytics > Charts, or call GET /v2/projects/{project_id}/charts/revenue with a secret key that has the charts_metrics:charts:read permission. The response has the same shape as RevenueCat's Charts API, so scripts written for it keep working. The charts guide lists every rule.
Worked example
Illustrative numbers for one month. Revenue adds the four money lines and subtracts the refunds recorded in the month.
| Line | March |
|---|---|
| New subscription purchases | $400 |
| Renewals | $1,200 |
| One-time purchases | $100 |
| Ad revenue | $50 |
| Refunds recorded in March | −$60 |
Revenue for March = 400 + 1,200 + 100 + 50 − 60 = $1,690.
Why it matters
Revenue is the number that pays for servers, ads and salaries, so it is the first place to look after a release, a price change or a campaign. A weekly line shows whether last week's paywall test moved money, and a segment by country shows where a price or localization change helped.
Revenue and MRR answer different questions. Revenue is cash received in the period, so an annual renewal lands in one month and makes the line jump. Use revenue to plan cash and judge a launch, and use MRR to judge the trend of the subscription base. If revenue falls while MRR holds, look at one-time purchases, ad revenue and refunds.
proceeds before you plan spending. Proceeds subtract the store commission.incomplete: true in the API.API
Same path and response shape as RevenueCat's Charts API, so existing scripts keep working.
curl "https://api.revenuedot.app/v2/projects/$PROJECT_ID/charts/revenue?resolution=day" \
-H "Authorization: Bearer $SECRET_KEY" # sk_... with charts_metrics:charts:read Reference: Charts guide · REST API v2
FAQ
Yes. Refunds reduce revenue on the day the store recorded them, not on the purchase date. A refund that is later reversed adds the money back on the reversal date. The Transactions measure is not reduced by refunds.
Revenue is the gross amount customers paid. Revenue net of taxes takes out the tax inside each price, and proceeds then take the store commission from what is left. RevenueDot uses the tax the store reported (Stripe, Paddle, Google Play orders), else the standard VAT or GST rate of the buyer's country.
Yes. Ad revenue that the SDK reports through ad revenue events is added to the revenue chart. The same money also has its own Ad Revenue chart.
US dollars, converted at the exchange rate of each purchase date. You can display the chart in another currency, and RevenueDot converts the USD amount at the same date's rate.
No. Sandbox and Test Store purchases are left out. Turn on the Sandbox data switch, or pass environment=sandbox to the API, to see only those.
Get started
Connect your app to RevenueDot Cloud, which is free until your app makes $10,000 a month. All 43 charts fill as purchases arrive, and an app moving from RevenueCat brings its history with it.
Already have an account? Sign in · Switching from RevenueCat? Change one line