Cron Next Runs API - Free Schedule Preview
Calculate the next N occurrences for a cron expression. Optionally specify a starting date with the from parameter.
Code examples
curl -X POST https://api.botoi.com/v1/cron/next \
-H "Content-Type: application/json" \
-d '{"expression":"0 9 * * 1-5","count":3,"from":"2026-03-27T00:00:00Z"}'When to use this API
Scheduling confirmation in admin panels
Show users the next 5 run times when they configure a cron schedule, so they can verify the timing before saving.
Monitoring gap detection
Compare the expected next run times with actual execution logs to detect missed or delayed cron jobs.
Frequently asked questions
What timezone are the results in?
All results are in UTC, returned as ISO 8601 timestamps with a Z suffix.
How many future occurrences can I request?
The count parameter accepts values from 1 to 25.
Can I calculate runs from a specific date?
Yes. Pass an ISO 8601 date in the from parameter to start the calculation from a date other than now.
What date format are the results in?
Results are ISO 8601 timestamps in UTC, e.g., 2026-03-27T09:00:00.000Z.
Get your API key
Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.