# PayWeave Scheduler – Get Schedule by ID

> PayWeave Scheduler – Get Schedule by ID is a paid API for AI agents from scheduler.payweave.services, paid per call via x402, $0.0005/call, status unknown (last checked 2026-09-13).

Retrieve the current status, run history, and next scheduled execution time for a specific scheduled callback job by its ID.

## Facts

- Endpoint: GET https://scheduler.payweave.services/schedules/%7Bid%7D
- Price: $0.0005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/payweave-scheduler-get-schedule-by-id-bb60605d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OB74uSatY-2acA5v2A0SJ

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 payweave-scheduler-get-schedule-by-id-bb60605d
```

Example prompt: Can you check the current status of my PayWeave scheduled job with ID 'sched_abc123' — I want to know when it last ran, when it's due to run next, and how many runs are left?

## When to prefer this

Use this endpoint when you have an existing schedule ID and need to inspect its current state, run history, or upcoming execution time — for example, to confirm a schedule is still active, audit past runs, or determine when the next callback will fire. This is a read-only status check, not a creation or modification endpoint.

## Known failure modes

- Schedule ID not found – returns 404 if the provided ID does not exist
- Unauthorized – missing or invalid x402 payment header returns 402 Payment Required
- Malformed ID – invalid ID format may return 400 Bad Request
- Service unavailable – transient infrastructure error returns 503

## How this service works

Durable scheduled and recurring HTTP callbacks for agents. Trigger future actions without keeping a process alive.

## Output

Returns a JSON object with the schedule's ID, kind, status, creation timestamp, next and last run timestamps, total run count, runs remaining, optional label and metadata, and an array of run records each containing the fired-at time, success flag, HTTP status code, and attempt count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "bodyType"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "type": "string",
     "const": "GET"
    },
    "bodyType": {
     "type": "string",
     "const": "json"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "example"
   ],
   "properties": {
    "example": {
     "type": "object",
     "required": [
      "id",
      "kind",
      "status",
      "createdAt",
      "nextRunAt",
      "lastRunAt",
      "runCount",
      "runsRemaining",
      "runs"
     ],
     "properties": {
      "id": {
       "type": "string"
      },
      "kind": {
       "type": "string"
      },
      "runs": {
       "type": "array",
       "items": {
        "type": "object",
        "required": [
         "firedAt",
         "ok",
         "httpStatus",
         "attempts"
        ],
        "properties": {
         "ok": {
          "type": "boolean"
         },
         "error": {
          "type": "string"
         },
         "firedAt": {
          "type": "number"
         },
         "attempts": {
          "type": "number"
         },
         "httpStatus": {
          "type": [
           "number",
           "null"
          ]
         }
        },
        "additionalProperties": false
       }
      },
      "label": {
       "type": "string"
      },
      "status": {
       "type": "string"
      },
      "metadata": {
       "type": "object",
       "additionalProperties": {}
      },
      "runCount": {
       "type": "number"
      },
      "createdAt": {
       "type": "number"
      },
      "lastRunAt": {
       "type": [
        "number",
        "null"
       ]
      },
      "nextRunAt": {
       "type": [
        "number",
        "null"
       ]
      },
      "runsRemaining": {
       "type": "number"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/payweave-scheduler-get-schedule-by-id-bb60605d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from scheduler.payweave.services](https://www.zero.xyz/host/scheduler.payweave.services/llms.txt)