Account-wide payer list
Returns every fan who paid in the selected window, grouped by fan with net, purchase count, first/last dates, and best-effort source/country attribution. Requires a read-scoped key.
Authorization
bearerAuth Your al_live_<prefix>_<secret> API key. Mint and manage keys in the dashboard.
In: header
Query Parameters
Windows the payer list; omitted/unknown means all-time.
Value in
- "24h"
- "7d"
- "30d"
- "90d"
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/api/admin/spenders"{ "spenders": [ { "fan_id": "u123456", "fan_username": "john", "total_net_cents": 4500, "purchases": 3, "source": "Main IG", "country": "US", "is_returning": false, "pre_anchor_cents": 0, "first_at": "2026-05-01T12:00:00Z", "last_at": "2026-06-20T08:30:00Z" } ], "totals": { "revenue_cents": 520000, "spenders": 880, "purchases": 2100 }}{ "detail": "Invalid or missing API key"}{ "detail": { "code": "engine_not_connected", "message": "Connect your engine to access this data." }}Paying fans of one source domain
Returns the paying fans attributed to one source domain, each with lifetime/windowed net, country, and a new-vs-returning flag. Requires a read-scoped key.
One fan's spender detail
Returns one paying fan's detail card: identity, country/source, lifetime net/gross, tracking period, per-day net series, RFM/lifecycle profile, and the transactions list. Requires a read-scoped key.