Cron describe
Exactcron_describeDeterministic and authoritative — the canonical answer for this input.
Describe a cron expression in plain English. Example: '0 9 * * 1-5' becomes 'At 09:00, Monday through Friday'. Descriptions are English-only ('en'); any other locale is rejected as INVALID_INPUT at no cost. Useful for confirming user intent before committing to a schedule. Processing multiple inputs? Use `cron_describe_batch` to do up to 1000 in one call.
Parameters
expressionstringrequiredlocalestringoptionalDescription locale. Only 'en' (English) is supported; any other value is rejected as INVALID_INPUT (cost 0).
Call it
curl -X POST https://api.snipget.ai/v1/cron/describe \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"expression":"0 9 * * 1-5"}'The Batch tab sends up to 1000 inputs in one call via /v1/cron/describe/batch.
Example response
{
"input": "0 9 * * 1-5",
"is_valid": true,
"description": "At 09:00, Monday through Friday",
"dialect": "standard",
"locale": "en"
}FAQ
Why use this instead of reading the cron myself?
Cron expressions like '0 9 * * 1-5' are cryptic, and language models often misread the day-of-week or hour fields. This turns the expression into a plain-English sentence deterministically, so it is the canonical reading, ideal for confirming a schedule with a user before you set it up.
What does the answer look like?
A human-readable sentence such as 'At 09:00, Monday through Friday', plus the detected dialect and the locale used.
Can I get the description in another language?
Not yet. Descriptions are English-only, and the locale parameter accepts only 'en'. Any other code is rejected as INVALID_INPUT at no cost, rather than silently returning English.
What does it NOT do?
It describes the schedule but does not tell you the actual upcoming run dates and times. For that, use Enumerate next cron runs.
What if the expression is invalid?
You get a normal answer with is_valid set to false, confidence 0, and a why_invalid reason instead of an error, so there is nothing to catch.