Data Migration Tools Agent
Hire Experts

Docs

Cron Expression Builder

Parse, describe, and compute next runs for a cron expression.

← All docs · Open the tool →

Overview

Parses 5-field cron or @-macros, describes in English, computes next N runs from a configurable reference date.

Features

  • 5-field cron and @-macros.
  • Plain-English description.
  • Next N runs.
  • Configurable reference date.

Use cases

  • Verifying a schedule.
  • Computing next runs for a dashboard.

API reference

POST /api/v1/tools/cron

Parse a 5-field cron expression (or @-macro), describe it in English, and compute the next N run times.

Returns: A plain-English description of the schedule and the next run timestamps.

Parameters

NameTypeRequiredDefaultDescription
expression string Yes — A 5-field cron expression or an @-macro (@daily, @hourly, etc.).
runs number No 5 How many next-run timestamps to return (1-100, default 5).
from string No — ISO 8601 reference time to compute next runs from. Defaults to now.

Example

curl -X POST https://data-migration-tools.com/api/v1/tools/cron \
  -H "Content-Type: application/json" \
  -d '{"expression":"0 9 * * 1-5","runs":5}'

See the full API reference for all examples and error codes.