# Cron next run times

List the next run times of a cron expression after a given moment, in the time zone you choose.

- Endpoint: `POST https://setget.net/v1/tools/cron-next-runs` with JSON `{"input": {...}}`
- MCP: `run_tool` with `slug` = `cron-next-runs`
- Page: https://setget.net/tools/cron-next-runs

## Inputs

- `expression` (required, string): A five-field cron expression or a macro such as @daily.
- `start` (required, string): Runs are listed strictly after this date and time.
- `zone` (optional, string, default `"UTC"`): Time zone the schedule runs in.
- `count` (optional, integer, default `5`, range 1..50): How many run times to list.

## Example 1

```json
{"input":{"expression":"0 9 * * 1-5","start":"2026-03-05T10:00","zone":"Europe/Oslo","count":3}}
```

Result:

```json
{"expression":"0 9 * * 1-5","description":"At 09:00 on Monday to Friday.","zone":"Europe/Oslo","after":"2026-03-05T10:00:00+01:00","runs":["2026-03-06T09:00:00+01:00","2026-03-09T09:00:00+01:00","2026-03-10T09:00:00+01:00"],"runs_utc":["2026-03-06T08:00:00Z","2026-03-09T08:00:00Z","2026-03-10T08:00:00Z"],"note":null}
```

## Example 2: Day of month or day of week

```json
{"input":{"expression":"0 0 15 * 1","start":"2026-03-01","count":4}}
```

Result:

```json
{"expression":"0 0 15 * 1","description":"At 00:00 on day 15 of the month or on Monday.","zone":"UTC","after":"2026-03-01T00:00:00+00:00","runs":["2026-03-02T00:00:00+00:00","2026-03-09T00:00:00+00:00","2026-03-15T00:00:00+00:00","2026-03-16T00:00:00+00:00"],"runs_utc":["2026-03-02T00:00:00Z","2026-03-09T00:00:00Z","2026-03-15T00:00:00Z","2026-03-16T00:00:00Z"],"note":null}
```

**What happens when both day fields are set?** Standard cron runs when either one matches. "0 0 13 * 5" runs on the 13th and also on every Friday, not only on Friday the 13th. The exception is a day field that starts with *, such as */2: then both must match.

**Which syntax is supported?** Five fields with values, lists (1,15), ranges (1-5), steps (*/10, 10-40/5), month and weekday names (JAN, MON), and the macros @yearly, @monthly, @weekly, @daily and @hourly. Seconds, years, L, W and # are not supported.

**Why must I send a start time?** So the same request always gives the same answer. Use time-now to get the current time if you want runs from now.

**What happens around daylight saving changes?** A run at a clock time that is skipped when clocks go forward does not happen that day. A clock time that occurs twice when clocks go back runs once, the first time. A note is added when a run is skipped.
