Cron Translator Build API
The Build API from Cron Translator — 1 operation(s) for build.
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-build-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 Build 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: Build
paths:
/api/v1/build:
get:
operationId: buildCron
summary: Build a cron expression from an English phrase
description: 'Rule-based English-to-cron conversion — not a language model. Returns 400 with the list of supported phrasings when a phrase falls outside the grammar, rather than guessing. Inspect `ignored_words`: leftover words can mean the phrase was misread.'
parameters:
- name: phrase
in: query
required: true
description: English schedule description.
schema:
type: string
examples:
- every minute
- every 5 minutes
- every hour
- every 6 hours
- every day at 9am
- every day at 14:30
- every monday at 9am
- every weekday at 8:15am
- every weekend at 10am
- on the 1st of every month at midnight
- every year on January 1 at noon
- 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
responses:
'200':
description: The expression, plus its explanation.
content:
application/json:
schema:
type: object
properties:
phrase:
type: string
expression:
type: string
matched_rule:
type: string
ignored_words:
type: array
items:
type: string
description:
type: string
warnings:
type: array
items:
type: object
required:
- code
- severity
- title
- detail
properties:
code:
type: string
severity:
type: string
enum:
- info
- caution
- error
title:
type: string
detail:
type: string
fixHint:
type: string
next_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.
timezone:
type: string
'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:
- Build
externalDocs:
url: https://crontoenglish.com/llms-full.txt
description: Full documentation for agents