Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Developer Utilities Tier 3 All-Access

Cron Expression Explainer & Next-Runs Calculator API — 5/6/7-Field & Timezones

Validate cron expressions, translate to plain English, and compute next N runs with DST. Validate standard 5-field, 6-field (seconds), AWS/Quartz, and @macros cron expressions, translate them to plain English, and compute next N runs with DST.

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/cron-explainerinput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "valid": true,
    "normalized_expression": "0 9 * * 1-5",
    "format": "5-field",
    "timezone": "Europe/Budapest",
    "explanation": "At 09:00, Monday through Friday (Europe/Budapest)",
    "fields": {
      "seconds": "0",
      "minutes": "0",
      "hours": "9",
      "day_of_month": "*",
      "month": "*",
      "day_of_week": "1-5"
    },
    "next_runs": [
      {
        "iso_utc": "2026-11-16T08:00:00.000Z",
        "local_time": "2026-11-16T09:00:00+01:00",
        "epoch_ms": 1794816000000,
        "utc_offset": "+01:00"
      },
      {
        "iso_utc": "2026-11-17T08:00:00.000Z",
        "local_time": "2026-11-17T09:00:00+01:00",
        "epoch_ms": 1794902400000,
        "utc_offset": "+01:00"
      },
      {
        "iso_utc": "2026-11-18T08:00:00.000Z",
        "local_time": "2026-11-18T09:00:00+01:00",
        "epoch_ms": 1794988800000,
        "utc_offset": "+01:00"
      },
      {
        "iso_utc": "2026-11-19T08:00:00.000Z",
        "local_time": "2026-11-19T09:00:00+01:00",
        "epoch_ms": 1795075200000,
        "utc_offset": "+01:00"
      },
      {
        "iso_utc": "2026-11-20T08:00:00.000Z",
        "local_time": "2026-11-20T09:00:00+01:00",
        "epoch_ms": 1795161600000,
        "utc_offset": "+01:00"
      }
    ],
    "warnings": [],
    "errors": []
  },
  "meta": {
    "request_id": "req_cron_01",
    "ms": 2
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/cron-explainer" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"expression":"0 9 * * 1-5","timezone":"Europe/Budapest","count":3,"from_time":"2026-11-14T08:00:00Z"}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/cron-explainer", {
  "expression": "0 9 * * 1-5",
  "timezone": "Europe/Budapest",
  "count": 3,
  "from_time": "2026-11-14T08:00:00Z"
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/cron-explainer",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "expression": "0 9 * * 1-5",
  "timezone": "Europe/Budapest",
  "count": 3,
  "from_time": "2026-11-14T08:00:00Z"
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/cron-explainer", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "expression": "0 9 * * 1-5",
  "timezone": "Europe/Budapest",
  "count": 3,
  "from_time": "2026-11-14T08:00:00Z"
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_cron_explainer",
    "arguments": {
      "expression": "0 9 * * 1-5",
      "timezone": "Europe/Budapest",
      "count": 3,
      "from_time": "2026-11-14T08:00:00Z"
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/cron-explainer)

ParameterType & ConstraintsDescription
expression required string
minLen: 1, maxLen: 256
5-field UNIX cron, 6-field cron (with leading seconds), or macro (@hourly, @daily, @weekly, @monthly, @yearly, @reboot). Supports L, W, and #.
timezone optional string
minLen: 1, maxLen: 64, default: "UTC"
IANA timezone name (e.g. 'UTC', 'Europe/Budapest', 'America/New_York').
count optional integer
min: 1, max: 50, default: 5
Number of upcoming execution times to compute (1 to 50).
from_time optional string Optional ISO-8601 starting timestamp (defaults to current UTC time).

Response data Object Fields (200 OK)

FieldTypeDescription
valid boolean Field 'valid'
normalized_expression string | null Field 'normalized_expression'
format "5-field" | "6-field" | "macro" | "reboot" | "invalid" Field 'format'
timezone string Field 'timezone'
explanation string | null Field 'explanation'
fields object | null Field 'fields'
next_runs object[] Field 'next_runs'
warnings string[] Field 'warnings'
errors string[] Field 'errors'

What Cron & Schedule Explainer & Validator API Detects & Validates

  • Supports POSIX 5-field, 6-field (with seconds), Quartz/AWS extensions (L, W, #), and @hourly/@daily/@weekly/@monthly macros
  • Human-readable English summary of any schedule
  • Computes next N occurrences in any IANA timezone (e.g. Europe/Budapest, America/New_York) with DST transition warnings
  • Flags footguns like simultaneous day-of-month and day-of-week OR semantics
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Computes up to 50 future occurrences per request within a 5-year lookahead window.
  • Tested v1.0.4 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Does it warn about the classic DOM + DOW cron trap?

Yes! In standard POSIX cron, specifying both day-of-month and day-of-week uses OR logic rather than AND. The API explicitly warns when both are restricted.

Does it support IANA timezones and Daylight Saving Time?

Yes, pass any IANA timezone name (e.g. Europe/Budapest) and it calculates exact local offsets and flags spring-forward/fall-back DST jumps.

Are @daily, @weekly, and 6-field seconds supported?

Yes, both standard macros and 6-field second-precision cron strings are supported.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Pure deterministic calculation in V8 memory.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/ics-sanitizer Developer Utilities

ICS / iCalendar Feed Sanitizer & Validator API

Repair broken .ics calendar feeds, normalize Windows timezones to IANA, and parse VEVENTs.

POST /v1/workday-holiday/between Compliance & Business

Workday & Holiday Calculator API

Calculate business days and SLA deadlines across 30+ countries including HU swap Saturdays.

POST /v1/locale-value-parser AI Data Prep

Text-to-Structured Date, Money & Unit Parser API

Normalize messy EU/US prices, dates, percentages, and measurements into structured JSON.