Skip to main content
GET
Return the wallet owner’s spend on memory operations over a given period, broken down by operation type. Unbilled — calling this endpoint is always free and works even when the wallet is empty. Use this endpoint to:
  • Power a “Memory spend” widget in your own dashboard
  • Alert on daily/monthly spend thresholds
  • Reconcile refunds against original charges

Request

Headers

string
required
Bearer token with your API key

Query parameters

string
default:"current_month"
Time window to aggregate over. One of:
  • current_month — from midnight on the 1st of the current month
  • last_30_days — rolling 30-day window ending now
  • all_time — all history (since the transaction log was created)

Response

boolean
true on success.
object

Example

Notes

  • Refunds appear as separate service types (MEMORY_EXTRACT_REFUND, MEMORY_INGEST_REFUND, etc.) with negative net_spend_usd. This preserves an auditable distinction between “a charge that happened and was reversed” vs “no charge at all”.
  • The billing_owner.current_balance_usd reflects the live wallet — it is not period-scoped, it’s always the current balance regardless of which period you requested.
  • For a full operation-level audit trail (every single row in transaction_log), use the dashboard — this endpoint is an aggregated summary.