VEverbiflow
billing

Get Recent Usage

What did the caller spend in the last N minutes? No play_id needed.

Aggregates the same four ledgers as /api/billing/cost-by-play but filters by created_at >= now() - interval instead of by play. Use when an SDK session ran without a registered play and you still want "what did I just spend".

  • minutes (default 60, max 1440 = 24h): lookback window.
  • actor_only (default true): include canonical Growth and enrichment capability movements carrying the caller's exact actor identity. Source and legacy enrichment ledgers lack that attribution and are excluded. Pass false for the complete workspace-wide net total across every ledger.
get/api/billing/recent-usage

Request

  • Base URL
    https://platform.verbiflow.com/api/bridge
  • URL
    https://platform.verbiflow.com/api/bridge/api/billing/recent-usage
  • Auth
    • HTTP bearer and API key in header x-flage-org-id
    • or HTTP bearer and API key in header x-flage-org-slug

Query parameters

minutesinteger
actor_onlyboolean

Response

Successful Response

actor_idstring nullable required

Actor filter applied to attributable ledgers, or null for workspace-wide usage.

credits_usedstring required

Exact net credit quantity in canonical decimal notation. Negative values are refunds or corrections recorded during the selected window.

event_countinteger required

Accounting events in the measured window.

sincestring date-time required

Inclusive UTC start of the measured window.

untilstring date-time required

Exclusive UTC end of the measured window.

usd_costnumber required

Projected net USD equivalent at the workspace current overage-credit rate, rounded to six decimal places. Negative values represent refunds or corrections; this is not provider cost or an invoiced amount.

usd_per_creditnumber required

Current workspace overage-credit price in US dollars used for this projection; zero can mean a configured zero rate or unavailable commercial terms and does not prove that work is free.

Changes

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