# WithZero Scheduler Task Ledger

> WithZero Scheduler Task Ledger is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP, price unknown, status unknown (last checked 2026-09-13).

Returns a cursor-paginated, append-only money ledger for a specific scheduled task, showing all debit/credit entries and running balances.

## Facts

- Endpoint: GET https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/ledger
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-withzero-scheduler-task-ledger-a8c8a600
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_J854zg1T3CFy1W6O48ynB

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 agents-withzero-xyz-withzero-scheduler-task-ledger-a8c8a600
```

Example prompt: Show me the full billing ledger for my scheduled task with ID 'a3f8c21d-1234-5678-abcd-000000000001' — I want to see every charge and credit entry, the running available balance, and whether it's on the direct or ZeroClick billing rail.

## When to prefer this

Use this endpoint when you need a detailed, paginated financial audit trail for a specific task — including per-entry balances, on-chain tx hashes, and the authoritative billing source. Prefer this over the cross-task rollup endpoint when you need entry-level granularity rather than an aggregate summary, or when reconciling individual run charges against on-chain records.

## Known failure modes

- Task ID not found or not owned by caller — likely 404 or 403
- Invalid UUID format for task ID — validation error
- Empty entries array if task has no ledger activity yet
- next_cursor becomes null when all pages are exhausted
- ZeroClick rail entries are operational only; authoritative billing lives in marketplace usage ledger, not here

## How this service works

Cursor-paginated task audit. Direct rail: authoritative append-only money ledger. ZeroClick rail: operational rows only; ZeroClick marketplace usage is authoritative for buyer billing. 📖 Full guide: https://scheduler.withzero.xyz/llms.txt

## Output

Returns a JSON object containing: an array of ledger entries (each with UUID, kind, signed amount in micros, available and reserved balances after, optional on-chain tx hash, optional run_id, metadata, and created_at timestamp), a next_cursor for pagination (null if no more pages), the billing_rail ('direct' or 'zeroclick'), and the authoritative_billing source ('scheduler_ledger' or 'zeroclick_marketplace').

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id"
 ],
 "properties": {
  "id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "billing_rail",
  "authoritative_billing",
  "entries",
  "next_cursor"
 ],
 "properties": {
  "entries": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "id",
     "kind",
     "amount_micros",
     "balance_available_after",
     "balance_reserved_after",
     "on_chain_tx",
     "run_id",
     "metadata",
     "created_at"
    ],
    "properties": {
     "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)$"
     },
     "kind": {
      "type": "string"
     },
     "run_id": {
      "anyOf": [
       {
        "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)$"
       },
       {
        "type": "null"
       }
      ]
     },
     "metadata": {
      "type": "object",
      "propertyNames": {
       "type": "string"
      },
      "additionalProperties": {}
     },
     "created_at": {
      "type": "string"
     },
     "on_chain_tx": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "amount_micros": {
      "type": "string",
      "description": "Signed; positive = inbound, negative = outbound."
     },
     "balance_reserved_after": {
      "type": "string"
     },
     "balance_available_after": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "next_cursor": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "billing_rail": {
   "enum": [
    "direct",
    "zeroclick"
   ],
   "type": "string"
  },
  "authoritative_billing": {
   "enum": [
    "scheduler_ledger",
    "zeroclick_marketplace"
   ],
   "type": "string",
   "description": "Direct buyer money is authoritative in this ledger. ZeroClick buyer billing is authoritative in the marketplace usage ledger."
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-withzero-scheduler-task-ledger-a8c8a600/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.withzero.xyz](https://www.zero.xyz/host/agents.withzero.xyz/llms.txt)