# List Task Runs (Cursor-Paginated)

> List Task Runs (Cursor-Paginated) is a paid API for AI agents from agents.withzero.xyz, paid per call via MPP, price unknown, status healthy (last checked 2026-09-14, last successful call 2026-09-04).

Returns a paginated list of slim per-run rows for a given scheduled task, including status, timing, cost, and trigger info, with cursor-based pagination up to 50 runs per page.

## Facts

- Endpoint: GET https://agents.withzero.xyz/api/v1/scheduler/tasks/{id}/runs
- Price: price unknown
- Payment: MPP
- Status: healthy
- Last checked: 2026-09-14
- Last successful call: 2026-09-04
- Success rate: 100% of calls made through Zero
- Activations on Zero: 1
- Provider: agents.withzero.xyz
- Website: https://agents.withzero.xyz
- Canonical page: https://www.zero.xyz/c/agents-withzero-xyz-list-task-runs-cursor-paginated-75106723
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ge8EFcVMMj2hZv2RTKTbN

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-list-task-runs-cursor-paginated-75106723
```

Example prompt: Show me the last 50 runs for task ID a1b2c3d4-e5f6-7890-abcd-ef1234567890 — I want to see their statuses, when they started and finished, exit codes, and how much each one cost.

## When to prefer this

Use this endpoint when you need to paginate through the execution history of a specific scheduled task and want lightweight row data (status, timing, cost, exit code) without full stdout/stderr logs. For a deep-dive into a single run's output, use the single-run detail endpoint instead. Prefer this endpoint when auditing cost, monitoring failure rates, or iterating through large run histories efficiently.

## Known failure modes

- Task ID not found or not owned by caller — returns 404 or 403
- Invalid cursor value causes pagination error — returns 400
- Limit exceeds 50 — may return 400 or be silently capped
- Task ID missing from path — returns 422 or 400
- Network or upstream scheduler error — returns 500

## How this service works

Slim per-run rows, cursor-paginated (limit ≤50). 📖 Full guide: https://scheduler.withzero.xyz/llms.txt

## Output

Returns a JSON object containing an array of slim run rows (each with UUID, status string, trigger type, exit code, started_at, finished_at, cost_total_micros, and sibling_call_count) plus a next_cursor string (or null if no more pages) for cursor-based pagination.

## 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": [
  "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
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-withzero-xyz-list-task-runs-cursor-paginated-75106723/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)