Cron Expression Parser
Parse a cron expression into a human-readable description and calculate next run times
Parameters
| name | in | type | required | description |
|---|---|---|---|---|
expression |
query | string | required | Standard 5-field cron or @daily, @hourly, etc. |
num_next |
query | number | optional |
Number of upcoming run times to show
range 1 to 20
default 5
|
timezone |
query | string | optional |
e.g. Europe/Zurich, America/New_York
default UTC
|
Request
Send your key in the X-API-Key header. More languages and patterns live on the
code examples page.
curl -s "https://apixies.io/api/v1/parse-cron?expression=%2A%2F5%20%2A%20%2A%20%2A%20%2A" \ -H "X-API-Key: YOUR_API_KEY"
Response
The result sits under data in the standard envelope. See the
response format guide for errors and status codes.
returns
- data.next_runs
- Upcoming run times in ISO 8601, five by default.
- data.human_readable
- Plain English version, like Every 5 minutes.
- data.fields
- The expression split into minute, hour, day, month and weekday.
- data.timezone
- Timezone used for next_runs.
{
"status": "success",
"http_code": 200,
"code": "SUCCESS",
"message": "Cron expression parsed successfully",
"data": {
"expression": "*/5 * * * *",
"human_readable": "Every 5 minutes",
"is_valid": true,
"fields": {
"minute": "*/5",
"hour": "*",
"day_of_month": "*",
"month": "*",
"day_of_week": "*"
},
"next_runs": [
"2026-09-18T12:05:00+00:00",
"2026-09-18T12:10:00+00:00",
"2026-09-18T12:15:00+00:00",
"2026-09-18T12:20:00+00:00",
"2026-09-18T12:25:00+00:00"
],
"timezone": "UTC"
}
}
Authentication and limits
This endpoint needs an API key. Use the sandbox ("try it" above) to test it without registering. See the authentication guide for details.
Standard rate limits apply to this endpoint.
related endpoints
More documentation
Get a free API key
A temporary key takes one click and no signup. Register and you get 75 requests/day. Free tier is for development & small projects.