{"uid":"cap_6ysJspusvMOarP7Sx_5po","slug":"scheduler-withzero-xyz-per-task-money-movement-ledger-cursor-paginated-51d15877","name":"Per-Task Money-Movement Ledger (Cursor-Paginated)","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://scheduler.withzero.xyz/api/v1/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","account"],"type":"string"},"authoritative_billing":{"enum":["scheduler_ledger","zeroclick_marketplace","account_ledger"],"type":"string","description":"Direct buyer money is authoritative in this ledger. ZeroClick buyer billing is authoritative in the marketplace usage ledger. Account-rail buyer billing is authoritative in GET /api/v1/account/ledger — this per-task feed is always empty for account-rail tasks."}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.82","reviews":0,"stars":null,"state":"rated"},"availabilityStatus":"unknown","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_yDvmFiE4aJbhRzl5srZcP","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"scheduler.tasks.ledger.list:1"}],"brandName":"scheduler.withzero.xyz","brandSlug":"scheduler-withzero-xyz-mpp","brandBaseUrl":"https://scheduler.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Returns the append-only, cursor-paginated audit trail of all money-movement ledger entries for a specific scheduled task.","exampleAgentPrompt":"Show me the full money-movement audit trail for task ID e3b0c442-98fc-4a3e-8b2d-6f1c9e7a0d52 — I want to see every inbound and outbound USDC entry, the running balances after each event, and any on-chain transaction hashes, starting from the beginning.","exampleUseCases":null,"resultDescription":"Returns a paginated list of ledger entries, each with a UUID entry ID, a kind string describing the event type, a signed amount in micros (positive = inbound, negative = outbound), available and reserved balance snapshots after the event, an optional on-chain transaction hash, an optional associated run ID, arbitrary metadata, and a created_at timestamp. Also includes a next_cursor string (or null if no more pages) for fetching subsequent pages.","failureModes":["404 Not Found — task ID does not exist or caller is not the owner","401/403 Unauthorized — missing or invalid ownership proof","400 Bad Request — malformed task UUID or invalid cursor token","500 Internal Server Error — database or infrastructure failure","Empty entries array with null next_cursor — task exists but has no ledger activity yet"],"whenToPreferThis":"Use this endpoint when you need a complete, tamper-evident financial audit trail for a specific scheduled task — especially when reconciling USDC charges, verifying on-chain transactions, tracking balance changes over time, or debugging billing anomalies. Prefer this over general task fetch (which doesn't return financial history) or run logs (which don't show money movements). Cursor pagination makes it suitable for tasks with long billing histories.","instructions":"# Task Ledger — money-movement audit trail\n\n## Contract\n- Append-only, cursor-paginated. Every deposit, per-run settle, and refund as auditable rows.\n- For a cross-task spend total instead, use GET /api/v1/owner/usage.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":11,"lastUsedAt":"2026-09-01T23:17:38.482Z","lastSuccessfullyRanAt":"2026-07-23T21:29:51.937Z","lastHealthCheckAt":"2026-09-09T06:35:23.503Z","isFirstParty":true}