Skip to content
GET /api/v1/parse-cron

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.
example response 200
{
    "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.

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.

cookies

We use analytics cookies to see how the site gets used. Nothing loads until you accept. Privacy policy