POST AI agent ready /v1/cron/next

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.

Endpoint

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.