▣ DEVELOPER TOOLS · STANDARD DATA

Schedule Cron API

What it does

Cron Next Times returns the next scheduled fire times for a standard 5-field cron expression. Send an expression query parameter, and optionally count to control how many upcoming times you want back.

The response includes the original expression and a next array of timestamp strings. count defaults to 5 and can be set from 1 to 20, which makes this useful for previewing schedules before you save them, validating user-entered cron strings, or showing the next run times in an admin UI.

Use Cron Next Times when you need to check whether a cron pattern matches the cadence you expect. It is a small, focused utility for scheduling workflows, background jobs, and reminders where the next execution times need to be computed consistently from a cron expression.

GET

Return the next N fire times for a standard 5-field cron expression

http://localhost:8080/dosvak/cron-next

QUICKSTARTGUIDE

Quickstart

Get the next cron times for an expression by passing the expression and count as query parameters.

curl -X GET "http://localhost:8080/dosvak/cron-next?expression=0%20%2A%20%2A%20%2A%20%2A&count=5" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

Returns a JSON object with:

next (array of string): the next scheduled run times
expression (string): the cron expression that was evaluated

{
  "next": [
    "2026-07-23T10:00:00Z",
    "2026-07-23T11:00:00Z"
  ],
  "expression": "0 * * * *"
}

TRY ITLIVE · 10 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Returns the next fire times for a standard 5-field cron expression. You provide the cron expression and can optionally limit how many future times are returned with count.

Query Parameter(s)

Attribute	Type	Mandatory	Description
count	Integer	No	Number of fire times to return. Default: `5`; minimum: `1`; maximum: `20`.
expression	String	Yes	Standard 5-field cron expression.

Response

Returns a JSON object with a next string array field and an expression string field. The next array contains the computed upcoming fire times, and expression echoes the cron expression associated with the result.

Parameter	Type	Mandatory	Description
next	String Array	No	Upcoming fire times returned for the provided cron expression.
expression	String	No	The cron expression associated with the returned schedule.

Query parameters

Name

Type

Description

countOPTIONAL

integer

—

DEFAULT 5

expressionREQUIRED

string

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.