Billing

Get the signed-in user's own per-turn µ spend (D5 per-user visibility)

Returns the CURRENT user's own per-turn spend, self-scoped by session sub only — there is no person_id parameter and a user can never read another person's turns. Each turn's µ value is a RATE-CARD ESTIMATE derived from token counts (usage_events stores no cost), NOT the authoritative account-scoped ledger burn — the response carries basis: "rate_card_estimate" and every µ field is named estimated_*. µ is the display unit (1 µ = 1¢ = 1000 mmu). Feature-gated by USAGE_SELF_SPEND_API_ENABLED; returns 404 to every caller (before auth) while the flag is off.

get/billing/usage/per-turn

Request

  • Base URL: https://api.mnemom.ai/v1
  • URL: https://api.mnemom.ai/v1/billing/usage/per-turn
  • Auth: one of:
    • HTTP bearer
    • API key in cookie mnemom_session

Query parameters

days7 | 30 | 90

Lookback window in days. One of 7, 30, 90.

limitinteger

Max turns per page (clamped to 200).

cursorstring

Opaque keyset cursor from a prior response's next_cursor.

product'research' | 'design' | 'develop' | 'operate' | 'canon' | 'unattributed' | 'all'

Optional product scope (sub-projects, contract C5). Omitted → today's response, unchanged. Usage events are not yet attributed to a product, so ANY valid product value returns 422 product_attribution_unavailable rather than silently returning unscoped data under a product label. An invalid value → 400 invalid_product. Applied AFTER auth/org/RBAC.

Response

The user's own per-turn spend (estimated) for the window.

fromstring date-time required
tostring date-time required
basis'rate_card_estimate' required

Always rate_card_estimate — the µ figures are derived from token counts, not the settled ledger burn.

next_cursorstring nullable required

Changes

No recorded changes to this operation across all 1 revision of this API.