# Cross-Task Spend Rollup for Calling Wallet

> Cross-Task Spend Rollup for Calling Wallet is a paid API for AI agents from scheduler.withzero.xyz, paid per call via MPP, metered — billed by usage, status healthy (last checked 2026-09-14, last successful call 2026-09-01).

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.

## Facts

- Endpoint: GET https://scheduler.withzero.xyz/api/v1/owner/usage
- Price: metered — billed by usage
- Payment: MPP
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-09-01
- Success rate: 100% of calls made through Zero
- Rating: 5.0 / 5 from 2 reviews
- Activations on Zero: 24
- Provider: scheduler.withzero.xyz
- Website: https://scheduler.withzero.xyz
- Canonical page: https://www.zero.xyz/c/scheduler-withzero-xyz-cross-task-spend-rollup-for-calling-wallet-5b2855d0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_2kFu-iLhVO_j5Q9Fk2EQV

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability scheduler-withzero-xyz-cross-task-spend-rollup-for-calling-wallet-5b2855d0
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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

## Output

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.

## Example request

```json
{}
```

## Response schema (JSON Schema)

```json
{
 "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/scheduler-withzero-xyz-cross-task-spend-rollup-for-calling-wallet-5b2855d0/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scheduler.withzero.xyz](https://www.zero.xyz/host/scheduler.withzero.xyz/llms.txt)