API Almanac
API reference › Cron

Validate a cron expression, say it in English and list its next runs in a time zone

GET/v1/cron

GET/v1/cron

Validate a cron expression, say it in English and list its next runs in a time zone

PARAMETERS
expressionquery · stringREQUIRED
Five-field cron or a macro like @daily
e.g. 0 9 * * 1-5
tzquery · string
Zone the schedule runs in
e.g. America/New_York
fromquery · string
Instant to start from (default now)
e.g. string
countquery · integer
How many upcoming runs
e.g. 5
In the full reference
REQUEST
curl "https://api.apialmanac.com/v1/cron?expression=0+9+%2A+%2A+1-5" \
  -H "X-API-Key: YOUR_KEY"
RESPONSE
200OK
{
  "expression": "0 9 * * 1-5",
  "normalized": "0 9 * * 1-5",
  "description": "At 09:00 Monday through Friday",
  "zone": "America/New_York",
  "from": "2026-10-09T15:00:00Z",
  "next": [
    {
      "utc": "2026-10-12T13:00:00Z",
      "local": "2026-10-12T09:00:00-04:00",
      "weekday": "Monday"
    },
    {
      "utc": "2026-10-13T13:00:00Z",
      "local": "2026-10-13T09:00:00-04:00",
      "weekday": "Tuesday"
    }
  ]
}
Try it — sign in first
Runs on a sandbox key: 200 requests a month. Your real key is for production.