# Cron Next Runs Calculator

> Cron Next Runs Calculator is a paid API for AI agents from dev-utils.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Computes the next N scheduled run times for a 5-field cron expression at a given UTC offset, applying the standard day-of-month/day-of-week OR rule

## Facts

- Endpoint: GET https://dev-utils.x402tookit.com/cron-next-runs?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cron-next-runs-calculator-d6600049
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_5Qy7sKZUlV7jPm39UHgt8

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 cron-next-runs-calculator-d6600049
```

Example prompt: Show me the next 10 run times for the cron expression '0 9 * * 1-5' starting from now, using UTC+05:30 as the local offset.

## When to prefer this

Use this endpoint when you need to preview, verify, or debug when a cron job will actually fire — especially useful when accounting for a specific timezone offset or when you need more than one future run time. Prefer this over manual cron parsing when the day-of-month and day-of-week OR interaction matters or when you need local-time representations alongside UTC.

## Known failure modes

- Invalid cron expression returns an error or degraded result with reasons explaining the parse failure
- n outside 1-30 range may be clamped or rejected
- Malformed UTC offset string causes offset to default to +00:00 or returns an error
- Unsupported shorthand aliases may not be recognized
- from timestamp in incorrect ISO format may cause a parsing error

## How this service works

Next N run times for a 5-field cron expression in a chosen UTC offset, with the day-of-month/day-of-week OR rule.

## Output

Returns an array of upcoming run times in both UTC and local offset format, along with the parsed cron expression, the UTC offset used, the start timestamp counted from, the day-of-month/day-of-week OR rule applied, a human-readable summary, and optional warnings or reasons if the result is degraded or partially unchecked.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "expr"
     ],
     "properties": {
      "n": {
       "type": "integer",
       "description": "How many runs, 1-30, default 5"
      },
      "expr": {
       "type": "string",
       "description": "Cron: minute hour day-of-month month day-of-week (or @daily etc.)"
      },
      "from": {
       "type": "string",
       "description": "ISO time to count from (exclusive), default now"
      },
      "utc_offset": {
       "type": "string",
       "description": "Fixed offset like +05:30 or -0800, default +00:00"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "dayRule": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "runsUtc": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "runsLocal": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "utcOffset": {
       "type": [
        "null",
        "string"
       ]
      },
      "disclaimer": {
       "type": [
        "null",
        "string"
       ]
      },
      "expression": {
       "type": [
        "null",
        "string"
       ]
      },
      "notChecked": {
       "type": [
        "array",
        "null"

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cron-next-runs-calculator-d6600049/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from dev-utils.x402tookit.com](https://www.zero.xyz/host/dev-utils.x402tookit.com/llms.txt)
