Cron Next Executions

Calculate the next N execution times for a cron expression

GET 1 credit /v1/cron-next

curl "https://devtools.toolkitapi.io/v1/cron-next?expression=0+9+*+*+1-5&count=5"

import httpx

resp = httpx.get(
    "https://devtools.toolkitapi.io/v1/cron-next?expression=0+9+*+*+1-5&count=5",
)
print(resp.json())

const resp = await fetch("https://devtools.toolkitapi.io/v1/cron-next?expression=0+9+*+*+1-5&count=5", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "expression": "0 9 * * 1-5",
  "from": "2024-03-15T10:00:00+00:00",
  "count": 5,
  "next": [
    "2024-03-18T09:00:00+00:00",
    "2024-03-19T09:00:00+00:00",
    "2024-03-20T09:00:00+00:00",
    "2024-03-21T09:00:00+00:00",
    "2024-03-22T09:00:00+00:00"
  ]
}

Try It Live

Description

Calculate the next N execution times for a cron expression

How to Use

1

1. Pass the cron expression in the `expression` query parameter. URL-encode spaces as `+` or `%20`.

2

2. Optionally set `count` to control how many upcoming times are returned (1–50, default 5).

3

3. Optionally set `from_date` to compute executions starting from a specific date instead of now.

4

4. Inspect the `next` array for the upcoming execution times in ISO 8601 format.

About This Tool

Cron Next Executions calculates the next N times a cron expression will fire, starting from now or a specified date. Use it to preview when a scheduled job will actually run — especially useful for complex expressions with day-of-week or month constraints.

Unlike Cron Parser, this endpoint focuses purely on computing upcoming execution times and supports a custom start date for "what if" scenarios.

Why Use This Tool

Schedule planning — Preview when a cron job will fire over the next week or month
What-if analysis — Set `from_date` to a future date to see how a schedule behaves around holidays or month boundaries
Monitoring — Verify a job's next execution time matches expectations
Migration testing — Confirm schedule behaviour when moving cron jobs between systems

Frequently Asked Questions

How is this different from Cron Parser?

Cron Parser returns a human-readable description plus next times. Cron Next focuses purely on computing upcoming execution times and supports a custom `from_date` for planning scenarios.

Can I get more than 50 results?

No. The maximum `count` is 50 to keep response sizes manageable.

What timezone are the results in?

Results are in UTC by default. If `from_date` includes a timezone offset, that timezone is used as the starting point.

Start using Cron Next Executions now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs