# Cron Next Execution Time Calculator

> Cron Next Execution Time Calculator is a paid API for AI agents from x402-micro-pay.com, paid per call via x402, $0.0031/call, status unknown (last checked 2026-11-20).

Parses a cron expression and returns the next N scheduled execution times in a given timezone, with UTC and epoch equivalents.

## Facts

- Endpoint: POST https://x402-micro-pay.com/api/skills/cron-next?utm_source=zero.xyz
- Price: $0.0031/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/cron-next-execution-time-calculator-8dc0cadf
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_AIiMtLLsNuPUSD8ap5-ok

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-execution-time-calculator-8dc0cadf -d '<json body>'
```

Example prompt: When will the cron expression '*/15 9-17 * * MON-FRI' next fire — give me the next 5 execution times in America/Chicago timezone starting from now?

## When to prefer this

Choose this endpoint when an AI agent needs to compute future cron trigger times on the fly without maintaining server infrastructure, especially useful for scheduling verification, auditing automation pipelines, or displaying human-readable upcoming job times to end users. Prefer this over manual cron parsing libraries when operating in a serverless or no-dependency context.

## Known failure modes

- Invalid cron expression syntax returns an error response
- Unrecognized or malformed timezone string causes failure
- Count exceeding maximum of 20 is rejected
- Malformed 'from' datetime string causes parsing error
- HTTP 402 returned if payment is not included — must pay via x402 on Base before retrying

## How this service works

41 pay-per-call JSON APIs for AI agents. No account or API key: an unpaid POST returns HTTP 402, pay in USDC on Base with x402 v2, retry. Prices from $0.001 per call.

## Output

Returns a JSON object with: the next N execution timestamps in the requested timezone (ISO 8601), the same times in UTC, Unix epoch seconds, the normalized cron expression string, and a breakdown of individual cron fields (hours, minutes, days of week, etc.). Also echoes back the input timezone and expression for confirmation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tz": {
   "type": "string",
   "default": "UTC",
   "maxLength": 64,
   "minLength": 1
  },
  "expr": {
   "type": "string",
   "maxLength": 200,
   "minLength": 1
  },
  "from": {
   "type": "string",
   "maxLength": 64,
   "minLength": 1
  },
  "count": {
   "type": "integer",
   "default": 5,
   "maximum": 20,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "tz": "America/Chicago",
  "expr": "*/15 9-17 * * MON-FRI",
  "from": "2026-10-16T12:42:00-05:00",
  "next": [
   "2026-10-16T12:45:00-05:00",
   "2026-10-16T13:00:00-05:00",
   "2026-10-16T13:15:00-05:00"
  ],
  "count": 3,
  "skill": "cron_next",
  "fields": {
   "hour": [
    9,
    10,
    11,
    12,
    13,
    14,
    15,
    16,
    17
   ],
   "month": [
    1,
    2,
    3,
    4,
    5,
    6,
    7,
    8,
    9,
    10,
    11,
    12
   ],
   "minute": [
    0,
    15,
    30,
    45
   ],
   "day_of_week": [
    1,
    2,
    3,
    4,
    5
   ],
   "day_of_month": [
    1,
    2,
    3,
    4,
    5,
    6,
    7,
    8,
    9,
    10,
    11,
    12,
    13,
    14,
    15,
    16,
    17,
    18,
    19,
    20,
    21,
    22,
    23,
    24,
    25,
    26,
    27,
    28,
    29,
    30,
    31
   ]
  },
  "next_utc": [
   "2026-10-16T17:45:00Z",
   "2026-10-16T18:00:00Z",
   "2026-10-16T18:15:00Z"
  ],
  "normalized": "*/15 9-17 * * MON-FRI",
  "next_epoch_s": [
   1792172700,
   1792173600,
   1792174500
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/cron-next-execution-time-calculator-8dc0cadf/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-micro-pay.com](https://www.zero.xyz/host/x402-micro-pay.com/llms.txt)
