Documentation

Examples

These URLs are already URL-encoded so they can be copied directly into Markdown, scripts, browser tests, or agent tool calls.

GET/api/v1/parseExplain every 5 minutes in JSON

Returns a summary, next run, next runs, and warnings for a Unix 5-field cron.

https://cronbadge.dev/api/v1/parse?expr=%2A%2F5%20%2A%20%2A%20%2A%20%2A&tz=UTC

GET/api/v1/badge.svgGitHub-style production badge

Compact badge with a custom left label and next run on the right segment.

https://cronbadge.dev/api/v1/badge.svg?expr=0%2012%20%2A%20%2A%201&tz=Europe%2FAmsterdam&label=production&summary=hide&next=show&timeFormat=weekday-time

GET/api/v1/badge.svgGitHub-style sandbox badge

Same badge format with a different injected label.

https://cronbadge.dev/api/v1/badge.svg?expr=0%2014%20%2A%20%2A%201&tz=Europe%2FAmsterdam&label=sandbox&summary=hide&next=show&timeFormat=weekday-time

GET/api/v1/card.svgWeekday release card

Larger schedule card using the same split GitHub-style visual language.

https://cronbadge.dev/api/v1/card.svg?expr=30%209%20%2A%20%2A%201-5&tz=Europe%2FAmsterdam&theme=light&count=3&timezoneLabel=show&expression=show&nextRunLabel=show

GET/api/v1/parseValidate a cron without rendering images

Best endpoint for agents that need structured data instead of SVG output.

https://cronbadge.dev/api/v1/parse?expr=30%209%20%2A%20%2A%201-5&tz=Europe%2FAmsterdam&count=3