Group completed invoice sales into price bands for one currency. Use this report for your Telegram subscription bot or Discord subscription bot project.
API key scope:analytics:charts:read for restricted keys. Unrestricted project keys also support this endpoint.
Path Parameters
project_idstringrequired
Project UUID.
Query Parameters
fromstring
First UTC calendar day, YYYY-MM-DD; default to minus 29 days.
tostring
Last UTC calendar day inclusive, YYYY-MM-DD; default today.
currencystring
Optional 3–9 letters or digits, any case; default currency with most sales.
boundsstring
1–10 comma-separated increasing positive decimals up to 1000000000, at most 2 fractional digits; maximum 139 characters. Default 10,25,50,100,250.
Dates must be real calendar days between 2000-01-01 and 2099-12-31, with from no later than to and at most 366 days inclusive. Unknown query parameters are rejected. There is no request body. See the shared analytics date, money, and cache rules.
A band includes its lower bound and excludes its upper bound; the final upper bound is null. Other currencies are counted separately and never converted. With no currency query, the currency with the most sales is selected, breaking ties alphabetically. No sales and no selected currency returns currency null. A requested currency with no sales returns zero totals.