Account analytics summary (with optional point-in-time as-of review)
Returns the account’s buying-analytics summary: RFM (recency / frequency / monetary + segment), account health score + band + trend, TTM revenue, average order value, and the revenue trend percentage.
Default (no as_of): the stored denormalized analytics columns (refreshed nightly
- incrementally on order events).
Point-in-time review (?as_of=YYYY-MM-DD): re-anchors the trailing windows
(recency, the 12-month TTM, and the 3-month revenue/frequency trend) to the
supplied historical date and recomputes RFM / health / TTM / revenue-trend IN
MEMORY. This is a READ-ONLY review — it NEVER persists, never updates the account,
never emits events. Useful for migrated accounts whose latest order predates today,
so you can see each customer’s standing “as of” the data’s latest point instead of
an arbitrary later wall-clock now. Industry precedent: NetSuite SuiteAnalytics
“As-Of Date”, Salesforce/HubSpot snapshot-date reports, QuickBooks/Xero “as of date”.
The review response is the same shape as the default plus as_of (the echoed date)
and is_review: true.
Authorizations
API key issued per entity via Settings > Developers > API Keys.
Each key carries scopes (e.g. orders:read, products:write).
Bearer token format: Authorization: Bearer ark_live_ent_
Test keys use ark_test_ent_. Both are issued per entity
via Settings > Developers > API Keys.
Path Parameters
Account UUID or account_number slug.
Query Parameters
Optional point-in-time review anchor (YYYY-MM-DD). Must be a real calendar date
and <= today. A malformed or future date returns 400 invalid_as_of_date.
Response
Account analytics summary (review path adds as_of + is_review).

