{"uid":"cap_vUfpA_yc1iqC4p1F68D7A","slug":"scheduler-withzero-xyz-list-task-run-history-cursor-paginated-b0badc61","name":"List Task Run History (Cursor-Paginated)","description":"Slim per-run rows, cursor-paginated (limit ≤50). 📖 Full guide: https://scheduler.withzero.xyz/llms.txt","url":"https://scheduler.withzero.xyz/api/v1/tasks/{id}/runs","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":["runs","next_cursor"],"properties":{"runs":{"type":"array","items":{"type":"object","required":["id","status","started_at","finished_at","exit_code","cost_total_micros","sibling_call_count","trigger"],"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)$"},"status":{"type":"string"},"trigger":{"type":"string"},"exit_code":{"anyOf":[{"type":"number"},{"type":"null"}]},"started_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"finished_at":{"anyOf":[{"type":"string"},{"type":"null"}]},"cost_total_micros":{"anyOf":[{"type":"string"},{"type":"null"}]},"sibling_call_count":{"type":"number"}},"additionalProperties":false}},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}]}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"proven_free","priceSource":"registry","requiresHandshake":false,"reviewCount":2,"rating":{"score":"1.00","successRate":"0.99","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_Fnxex6GRDRJW1G9LWNeJe","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"scheduler.tasks.runs.list:1"}],"brandName":"scheduler.withzero.xyz","brandSlug":"scheduler-withzero-xyz-mpp","brandBaseUrl":"https://scheduler.withzero.xyz","brandDocsUrl":null,"whatItDoes":"Returns slim, cursor-paginated rows of execution runs for a specific scheduled task, up to 50 per page.","exampleAgentPrompt":"Show me the last 50 runs for my scheduled task with ID 3f2e1d0c-1234-5678-abcd-ef0123456789 — I want to see their statuses, exit codes, and how much each run cost.","exampleUseCases":null,"resultDescription":"An array of slim run records each containing: UUID run ID, status string, trigger type, started_at and finished_at timestamps (nullable), exit code (nullable), cost_total_micros (nullable), and sibling_call_count. Also includes a next_cursor string (nullable) for fetching the next page of results.","failureModes":["Task ID not found or not owned by caller — 404 or 403","Invalid cursor token — 400 or 422","Limit exceeds 50 — 400 validation error","Authentication/proof missing or invalid — 401","Task has no runs yet — returns empty array with null next_cursor"],"whenToPreferThis":"Use this endpoint when you need to audit, monitor, or debug the execution history of a specific recurring or ad-hoc task managed by scheduler.withzero.xyz. It is the right choice when you need cost breakdowns per run, status checks, or want to paginate through a large history without fetching full run details.","instructions":"# List Runs — per-task run history\n\n## Workflow\n- Drill into one row: GET /api/v1/runs/{id}\n\n## Contract\n- Cursor-paginated, limit ≤50. Slim rows (no full stdout) — use Get Run for output.","reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":154,"lastUsedAt":"2026-09-02T00:46:21.633Z","lastSuccessfullyRanAt":"2026-09-02T00:46:21.633Z","lastHealthCheckAt":"2026-09-11T00:30:01.878Z","isFirstParty":true}