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 @dailye.g. 0 9 * * 1-5
- tzquery · string
- Zone the schedule runs ine.g. America/New_York
- fromquery · string
- Instant to start from (default now)e.g. string
- countquery · integer
- How many upcoming runse.g. 5
REQUEST
curl "https://api.apialmanac.com/v1/cron?expression=0+9+%2A+%2A+1-5" \ -H "X-API-Key: YOUR_KEY"
import requests
r = requests.get("https://api.apialmanac.com/v1/cron?expression=0+9+%2A+%2A+1-5", headers={"X-API-Key": "YOUR_KEY"})
print(r.status_code, r.headers.get("X-Gw-Remaining"))
print(r.json())
const r = await fetch("https://api.apialmanac.com/v1/cron?expression=0+9+%2A+%2A+1-5", {
headers: { "X-API-Key": "YOUR_KEY" }
});
console.log(r.status, r.headers.get("X-Gw-Remaining"));
console.log(await r.json());
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"
}
]
}