{"uid":"cap_J854zg1T3CFy1W6O48ynB","slug":"agents-withzero-xyz-withzero-scheduler-task-ledger-a8c8a600","name":"WithZero Scheduler Task Ledger","description":"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","url":"https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/ledger","method":"GET","headers":{},"bodySchema":{"type":"object","required":["id"],"properties":{"id":{"type":"string"}}},"responseSchema":{"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},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.000000","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"unknown","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_WZGqobjRG6AIgDhTCKSi7","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.000000","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.withzero.xyz","brandSlug":"agents-withzero-xyz-mpp","brandBaseUrl":"https://agents.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Returns a cursor-paginated, append-only money ledger for a specific scheduled task, showing all debit/credit entries and running balances.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Audit task spending after a long run","prompt":"Pull up the money ledger for my scheduler task ID 'b7e2a4f0-aaaa-bbbb-cccc-111111111111' so I can see every debit and credit entry and confirm how much has been charged across all its runs."},{"title":"Reconcile on-chain transactions for a task","prompt":"For task 'c9d1e5f3-2222-3333-4444-555555555555', fetch the ledger entries and show me which ones have on-chain transaction hashes so I can cross-reference them against my blockchain records."},{"title":"Check remaining balance after latest task run","prompt":"What's the available balance and reserved balance after the most recent ledger entry for my task ID 'd4b8a7c6-6666-7777-8888-999999999999'? I want to know if I need to top it up."}],"resultDescription":"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').","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:41:37.518Z","isFirstParty":true}