{"uid":"cap_2kFu-iLhVO_j5Q9Fk2EQV","slug":"scheduler-withzero-xyz-cross-task-spend-rollup-for-calling-wallet-5b2855d0","name":"Cross-Task Spend Rollup for Calling Wallet","description":"Cross-task usage rollup for the caller. current_balance_micros is refundable escrow on the direct rail and a non-refundable seller-local execution cap on the ZeroClick rail. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://scheduler.withzero.xyz/api/v1/owner/usage","method":"GET","headers":{},"bodySchema":null,"responseSchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["billing_rail","total_spend_micros","total_runs","current_balance_micros","top_tasks","next_cursor"],"properties":{"top_tasks":{"type":"array","items":{"type":"object","required":["task_id","lifetime_cost_micros","lifetime_runs"],"properties":{"task_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"lifetime_runs":{"type":"number"},"lifetime_cost_micros":{"type":"string"}},"additionalProperties":false}},"total_runs":{"type":"number"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]},"billing_rail":{"enum":["direct","zeroclick","account"],"type":"string"},"total_spend_micros":{"type":"string"},"current_balance_micros":{"type":"string","description":"Direct rail: aggregate remaining escrow. ZeroClick rail: aggregate remaining seller-local execution cap, not refundable money."}},"additionalProperties":false},"example":{"request":{},"response":{"top_tasks":[{"task_id":"0298cf1f-ab81-428b-8fa8-c1af6ec485b4","lifetime_runs":2,"lifetime_cost_micros":"31743"},{"task_id":"058e55ca-7d34-4d23-b7f0-d14f49ef0f5c","lifetime_runs":1,"lifetime_cost_micros":"5100"},{"task_id":"070f161f-9e1a-4dfa-b149-b5c29d64758d","lifetime_runs":2,"lifetime_cost_micros":"17577"},{"task_id":"0832a394-bbab-4acd-80bb-33e498e0e793","lifetime_runs":1,"lifetime_cost_micros":"15872"},{"task_id":"12585c4b-3012-49db-98d8-4cb4edb9e9f8","lifetime_runs":2,"lifetime_cost_micros":"10414"},{"task_id":"1c7faef8-cde2-4e7e-abb8-20f993ade3be","lifetime_runs":3,"lifetime_cost_micros":"26217"},{"task_id":"25f6d79b-4ea7-426c-b747-9da8dd92eabf","lifetime_runs":18,"lifetime_cost_micros":"91800"},{"task_id":"2db0e6f7-5452-442b-a813-e980cde31003","lifetime_runs":1,"lifetime_cost_micros":"11700"},{"task_id":"30bde180-842d-4d49-bdcb-bedc702006d2","lifetime_runs":7,"lifetime_cost_micros":"36359"},{"task_id":"325b7fdf-5a19-435a-94ff-43a247902058","lifetime_runs":1,"lifetime_cost_micros":"5100"},{"task_id":"36d134a3-bb3c-4c27-a6fc-60eb6adb0812","lifetime_runs":1,"lifetime_cost_micros":"44857"},{"task_id":"3dc1324d-887b-4472-bd4f-bfd90656211e","lifetime_runs":1,"lifetime_cost_micros":"7579"},{"task_id":"51560cf9-b3f3-4164-9d2f-5cd501963d2d","lifetime_runs":1,"lifetime_cost_micros":"5100"},{"task_id":"54019981-d8cf-4cbe-b22e-d7d380f7ca25","lifetime_runs":1,"lifetime_cost_micros":"11366"},{"task_id":"57e24545-0420-4db3-9671-d98baddd5301","lifetime_runs":1,"lifetime_cost_micros":"7696"},{"task_id":"580332a4-5126-4fba-8780-9b4cf8c583bb","lifetime_runs":7,"lifetime_cost_micros":"37918"},{"task_id":"5fcaec92-25b0-446a-ba14-fd4944fd9f84","lifetime_runs":1,"lifetime_cost_micros":"5300"},{"task_id":"62da66a6-8a57-4e4d-bf69-8d5ce36b5d53","lifetime_runs":1,"lifetime_cost_micros":"6100"},{"task_id":"63fd8a5c-cfc5-4b01-9896-34623b544965","lifetime_runs":2,"lifetime_cost_micros":"32645"},{"task_id":"78ef9dec-12fb-45e3-ba6e-10429a5cd3b3","lifetime_runs":1,"lifetime_cost_micros":"5100"},{"task_id":"94dbfa2a-5601-4837-8808-f0d0ad7529c5","lifetime_runs":1,"lifetime_cost_micros":"5100"},{"task_id":"9cfed590-2530-414d-a0be-790679e66620","lifetime_runs":1,"lifetime_cost_micros":"5100"},{"task_id":"9ff869c3-b9ac-4031-8bea-acc3a7cdd646","lifetime_runs":1,"lifetime_cost_micros":"83794"},{"task_id":"a3920a6a-e17a-4966-96da-d6b11bb3efae","lifetime_runs":1,"lifetime_cost_micros":"5100"},{"task_id":"ae950c25-e2e4-4b5d-83ea-10d0282ad1cb","lifetime_runs":2,"lifetime_cost_micros":"14910"}],"total_runs":107,"next_cursor":"ae950c25-e2e4-4b5d-83ea-10d0282ad1cb","total_spend_micros":"886565","current_balance_micros":"5977511"}},"exampleRequest":{},"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":2,"rating":{"score":"1.00","successRate":"1.00","reviews":2,"stars":"5.0","state":"rated"},"availabilityStatus":"healthy","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"metered","summary":"metered — billed by usage","primary":{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"metered","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_QMLDsfj-CilR7A2Tl4TIu","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"scheduler.owner.usage:1"}],"brandName":"scheduler.withzero.xyz","brandSlug":"scheduler-withzero-xyz-mpp","brandBaseUrl":"https://scheduler.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Returns an aggregated spending summary across all cron tasks owned by the authenticated wallet, including total spend, total runs, current balance, and top tasks by cost.","exampleAgentPrompt":"Give me a full spend rollup for my scheduler wallet — I want to see my total lifetime spend in micros, total runs, current balance, and which tasks have cost the most.","exampleUseCases":null,"resultDescription":"A JSON object containing: total_spend_micros (lifetime spend as string), total_runs (number), current_balance_micros (remaining balance as string), top_tasks (array of objects each with task_id UUID, lifetime_cost_micros, and lifetime_runs), and next_cursor for paginating top_tasks.","failureModes":["401 Unauthorized if wallet proof/auth header is missing or invalid","Empty top_tasks array if no tasks have been run yet","next_cursor is null when there are no more pages of top tasks","Stale data if billing pipeline has a lag"],"whenToPreferThis":"Use this endpoint when you need an owner-level aggregate view of all spending and run counts across every scheduled task under a single wallet, rather than querying individual task details one by one. Ideal for dashboards, budget monitoring, or deciding whether to top up your balance.","instructions":"# Owner Usage — cross-task spend rollup\n\n## Contract\n- Aggregate spend across ALL your tasks for the calling wallet. For one task's line-item trail, use GET /api/v1/tasks/{id}/ledger.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":24,"lastUsedAt":"2026-09-01T23:51:35.347Z","lastSuccessfullyRanAt":"2026-09-01T23:51:35.347Z","lastHealthCheckAt":"2026-09-14T19:02:02.198Z","isFirstParty":true}