Revenue API reference

Revenue

revenue.summaryread

Gross revenue collected by the account across native invoices, sales funnels, and every connected Stripe account for an optional date range, with refunds, transaction counts, and Stripe MRR after current discounts. MRR normalizes recurring charges to a month and excludes trials, metered usage, pauses, and scheduled cancellations. It reports pending subscriptions while Stripe previews are being refreshed. Invoice and funnel charges are removed from the general Stripe bucket so the all-sources total never double-counts them. The connected-Stripe figure is also broken out per connected Stripe account. Also returns what was collected today and yesterday in the account's own timezone, independent of the requested date range. Read-only; changes nothing and charges nobody.

Parameters

Field	Type	Required	Description
from	string (date-time)	optional	Inclusive start of the collection window as an ISO 8601 timestamp. Omit for all history.
to	string (date-time)	optional	Exclusive end of the collection window as an ISO 8601 timestamp. Omit to continue through now.
sources	array of ("invoices" \| "stripe" \| "funnels")	optional	Revenue sources to total: invoices, stripe, and/or funnels. Omit for all sources.
stripe_account_ids	string[]	optional	Restrict the connected-Stripe figures to these connected Stripe accounts, by the account id returned in stripe_accounts[].id. Omit to count every connected account. Invoice and funnel totals are unaffected.
timezone	string	optional	IANA timezone that defines where today and yesterday start, e.g. America/New_York. Omit to use the account's configured business timezone.

Example

curl -X POST https://app.chirply.io/api/v1/actions/revenue.summary \
  -H "Authorization: Bearer chp_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "2026-09-17T15:00:00Z",
    "to": "2026-09-17T15:00:00Z"
  }'

Test with your API key

Over MCP the same operation is the tool revenue_summary at https://app.chirply.io/api/mcp, same bearer token, same input.