About this endpoint
What it does
Computes the next N UTC fire times for a cron expression. You provide a 5-field cron expression, and can optionally control how many results to return with count and the starting Unix time with from_time.
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| expression | String | Yes | A 5-field cron expression in min hour dom month dow format. |
| count | Integer | No | How many upcoming run times to return. Allowed range: 1-50. Default: 5. |
| from_time | Integer | No | Unix seconds to compute from. Defaults to a fixed reference time. |
Response
Returns a JSON object with from and note string fields, count as an integer, timezone and expression as strings, and next_runs as an array of strings. The response is the computed schedule output for the requested cron expression, in UTC.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| from | String | No | The reference time used for the calculation. |
| note | String | No | Additional informational note returned by the service. |
| count | Integer | No | The number of run times returned. |
| timezone | String | No | The timezone associated with the results. |
| next_runs | String Array | No | The computed upcoming run times. |
| expression | String | No | The cron expression that was evaluated. |