List next (or previous) cron run times
next_cron_runsRead-onlyIdempotent
List the next (or, with direction "previous", the most recent past) run times of a cron expression in an IANA time zone, DST-aware. Each run has the local time with its UTC offset, the UTC time, unix seconds and weekday. Default 5 runs, max 20; searches up to 50 years. Read-only. Same engine as GET /api/next and GET /api/previous.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Start point (exclusive); default now. ISO 8601 with Z or an offset (2026-11-01T09:00:00Z), a local time read in the time zone (2026-11-01T09:00), or unix seconds. | |
| count | No | How many runs (1-20). | |
| timezone | No | IANA time zone the schedule runs in, e.g. "America/Denver", "Europe/London". Default UTC. | UTC |
| direction | No | "next" (default) or "previous" (most recent first). | next |
| expression | Yes | Cron expression, e.g. "0 9 * * 1-5", "*/15 * * * *", "0 30 8 * * *" (6 fields = leading seconds) or "@daily". |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | ||
| runs | Yes | ||
| notes | Yes | ||
| version | Yes | ||
| complete | Yes | ||
| timezone | Yes | ||
| direction | No | ||
| expression | Yes | ||
| normalized | No | ||
| description | No |