{"uid":"cap_qYsh4WtRe35_noN80UKfW","slug":"mekler-ai-cron-run-calculator-8d33fa93","name":"Mekler AI Cron Run Calculator","description":"Calculate up to 20 upcoming five-field cron runs in a named IANA timezone, strictly after an explicit timestamp through a 366-day horizon. Report UTC, local offset and fold. Skip nonexistent times; choose both, first or second repeated times. Calculation only: no scheduler, job execution or delivery.","url":"https://api.mekler.ai/v1/data/schedules/calculate-cron-runs?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"count":{"type":"integer","default":5,"maximum":20,"minimum":1},"start":{"type":"string","format":"date-time"},"timezone":{"type":"string","maxLength":100},"expression":{"type":"string","maxLength":128},"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,64}$"},"repeat_policy":{"enum":["both","first","second"],"type":"string","default":"both"}}},"responseSchema":{"type":"json","example":{"runs":[{"utc":"2026-10-20T16:30:00Z","fold":0,"local":"2026-10-20T09:30:00-07:00"},{"utc":"2026-10-21T16:30:00Z","fold":0,"local":"2026-10-21T09:30:00-07:00"},{"utc":"2026-10-22T16:30:00Z","fold":0,"local":"2026-10-22T09:30:00-07:00"},{"utc":"2026-10-23T16:30:00Z","fold":0,"local":"2026-10-23T09:30:00-07:00"},{"utc":"2026-10-26T16:30:00Z","fold":0,"local":"2026-10-26T09:30:00-07:00"}],"start":"2026-10-20T00:00:00+00:00","status":"ok","complete":true,"timezone":"America/Los_Angeles","expression":"30 9 * * MON-FRI","limitations":["Calculation only; no job is scheduled or delivered.","Five fields: minute hour day-of-month month day-of-week. Numeric lists, ranges, steps and English month/weekday abbreviations; Sunday is 0 or 7.","Day-of-month and day-of-week use OR when both fields differ from the literal *; otherwise both must match. No seconds, year, L, W, # or @ macros.","Nonexistent local times are skipped. Repeated times follow repeat_policy. Search is strictly after start through 366 elapsed days.","Uses the deployed IANA timezone database; future government rule changes may alter results."],"observed_at":"2026-10-20T00:00:00Z","repeat_policy":"both","search_end_utc":"2027-10-21T00:00:00+00:00","requested_count":5}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oBgVNotnQX2xKjSpJ81Je","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculate up to 20 upcoming scheduled fire times for a five-field cron expression in a named IANA timezone, handling DST folds and skips, strictly after a given start timestamp within a 366-day horizon.","exampleAgentPrompt":"Calculate the next 10 times this cron expression will fire: '0 9 * * MON-FRI', starting strictly after 2025-03-09T00:00:00Z, in the America/Chicago timezone — and use 'first' as the repeat policy for any DST-repeated times.","exampleUseCases":[{"title":"Preview weekly report schedule across DST","prompt":"I want to see the next 15 times my weekly report job will fire — it's on cron '0 8 * * MON', starting after 2025-10-25T00:00:00Z in Europe/London. Use 'both' for repeated times so I can see the DST rollback effect."},{"title":"Verify daily backup timing around spring-forward","prompt":"Can you calculate the next 5 runs of '30 2 * * *' starting after 2025-03-08T06:00:00Z in America/New_York? I want to know which one gets skipped due to the spring-forward clock change."},{"title":"Plan bi-weekly deployment windows","prompt":"Show me the next 20 fire times for cron expression '0 14 1,15 * *' after 2025-06-01T00:00:00Z in Asia/Tokyo — I need to plan my bi-weekly deployment windows for the next year."}],"resultDescription":"A JSON object containing an array of up to 20 scheduled run times, each with a UTC timestamp, a local-time timestamp with offset, and a fold indicator (0 or 1) for DST ambiguity. Also includes metadata: the original expression, timezone, start and search-end boundaries, the repeat policy used, run count requested, and a 'complete' flag indicating whether the requested count was fully satisfied within the 366-day horizon. Limitations about cron field support and DST behavior are listed.","failureModes":["Invalid or unsupported cron expression (e.g. 6-field, uses @macros, L/W/# syntax) returns an error","Unknown or misspelled IANA timezone name returns an error","Start timestamp outside parseable date-time format returns a validation error","Requesting more than 20 runs returns a validation error","No matching runs found within 366-day horizon returns complete:false with fewer results than requested","request_id pattern mismatch (not 16-64 alphanumeric/dash/underscore chars) returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need pure cron-expression expansion with proper IANA timezone and DST handling — including explicit control over how repeated (fold=1) times are treated and automatic skipping of nonexistent times. It is a pure computation service (no side effects, no job scheduling), making it safe to call repeatedly for previewing schedules. Prefer it over generic datetime libraries when DST correctness and fold-awareness are required, or when you need to preview a full schedule window up to 366 days ahead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:14:28.468Z","isFirstParty":false,"canonicalSlug":"mekler-ai-cron-run-calculator-8d33fa93"}