Appearance
Growth over time
GET
/analytics/growth-timeline
New cards and activity over time, as one series. Requires an UNRESTRICTED key: a key limited to specific locations is refused with 403 location_scope_unsupported, and shop-wide data is never silently served to it instead. This series is not derived from transactions, which are the only site-attributed rows in the system, so it cannot be narrowed to a location.
Authorizations
ApiKeyBearer
A shop-scoped API key created in the dashboard and shown exactly once. An MCP tmk_ key presented here returns a 401 that names the mistake.
Type
HTTP (bearer)
Parameters
Query Parameters
months*
Type
Requiredinteger
Responses
Growth over time
application/json
JSON "buckets": [ "2026-09-04" ], "new_cards": [ 37 ], "activity": [ 480 ]
{
}
GET
/analytics/growth-timeline