Cron Translator Next Runs API
The Next Runs API from Cron Translator — 1 operation(s) for next runs.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/crontoenglish-com:crontoenglish-com-next-runs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Cron Translator Next Runs API
version: 1.0.0
summary: Translate cron expressions to plain English — and back.
description: 'Explain any cron expression in plain English, see the next run times in any timezone, and catch the gotchas that make schedules misfire: day-of-month/day-of-week OR semantics, steps that do not divide evenly, impossible dates, and daylight-saving shifts.
**Not for:** Does not run, install, or manage scheduled jobs. Does not support Quartz extensions (L, W, #, ?) beyond detecting and reporting them.
Free tier: 250 calls per UTC day per caller. Past that, endpoints return 402 with x402 payment requirements. An MCP server exposing the same capabilities is available at https://crontoenglish.com/api/mcp.'
contact:
url: https://github.com/bwalvoord/gumball
servers:
- url: https://crontoenglish.com
description: Production
tags:
- name: Next Runs
paths:
/api/v1/next-runs:
get:
operationId: nextCronRuns
summary: List the next run times for a cron expression
description: Upcoming run times only. Each run is given as a UTC ISO 8601 instant and a local wall-clock string. Refuses Quartz-only syntax rather than guessing.
parameters:
- name: expression
in: query
required: true
description: 'Standard five-field cron expression: "minute hour day-of-month month day-of-week". Accepts *, numbers, ranges, lists, steps, three-letter month/day names, and the @daily/@hourly/@weekly/@monthly/@yearly macros.'
schema:
type: string
examples:
- 0 9 * * 1-5
- '*/15 9-17 * * 1-5'
- '@daily'
- name: timezone
in: query
required: false
description: IANA timezone name. Cron expressions carry no timezone, so this decides when the schedule fires.
schema:
type: string
default: UTC
examples:
- UTC
- America/New_York
- name: count
in: query
required: false
description: How many upcoming run times to return.
schema:
type: integer
minimum: 1
maximum: 25
default: 5
responses:
'200':
description: Upcoming run times.
content:
application/json:
schema:
type: object
properties:
expression:
type: string
timezone:
type: string
count:
type: integer
runs:
type: array
items:
type: object
required:
- iso
- local
properties:
iso:
type: string
format: date-time
description: UTC instant, ISO 8601.
local:
type: string
description: Wall-clock rendering in the requested timezone.
'400':
description: Invalid input. The body names the field and how to fix it.
content:
application/json:
schema:
type: object
required:
- error
properties:
error:
type: object
required:
- code
- message
- fix_hint
- docs
properties:
code:
type: string
description: Stable machine-readable error code.
message:
type: string
fix_hint:
type: string
description: What to change before retrying.
field:
type: string
token:
type: string
examples:
type: array
items:
type: string
docs:
type: string
format: uri
'402':
description: 'Free quota of 250 calls per UTC day exhausted. Body is an x402 v1 payment requirement ($0.001 per call, USDC on Base). While settlement is disabled the body carries payment_enabled: false and the call cannot be unblocked by paying — wait for quota.resetsAt.'
content:
application/json:
schema:
type: object
properties:
x402Version:
type: integer
error:
type: string
payment_enabled:
type: boolean
accepts:
type: array
items:
type: object
quota:
type: object
fix_hint:
type: string
docs:
type: string
tags:
- Next Runs
externalDocs:
url: https://crontoenglish.com/llms-full.txt
description: Full documentation for agents