{"uid":"cap_A5qV3iGsORjdAnk7TArM1","slug":"cron-expression-parser-next-run-calculator-09e65861","name":"Cron Expression Parser & Next-Run Calculator","description":"Standing infrastructure for ephemeral AI agents, paid per call over x402. Watches, dead-man switches, and multi-agent coordination. No account; wallet as identity.","url":"https://api.datasieve.xyz/utils/cron-next","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tz":{"type":"string","default":"UTC","description":"IANA timezone, default UTC"},"cron":{"type":"string","description":"5- or 6-field cron expression, e.g. \"0 9 * * 1-5\""},"count":{"type":"integer","default":5,"maximum":20,"minimum":1,"description":"how many upcoming run times to return"}}},"responseSchema":{"type":"json","example":{"tz":"UTC","cron":"0 9 * * 1-5","hint":"Want this cron to actually FIRE? POST /watch/standard with a schedule condition…","nextRuns":["2026-07-13T09:00:00.000Z","2026-07-14T09:00:00.000Z"],"secondsUntilNext":45000}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_2vOH-OflU06fP_VPqRvPK","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses a 5- or 6-field cron expression and returns the next N upcoming run times in any IANA timezone, plus seconds until the next execution.","exampleAgentPrompt":"What are the next 5 times that the cron expression '0 9 * * 1-5' will fire in the America/New_York timezone, and how many seconds until the first one?","exampleUseCases":null,"resultDescription":"Returns a list of the next N upcoming run timestamps (in ISO 8601 format) for the given cron expression in the requested IANA timezone, along with the number of seconds until the very next execution.","failureModes":["Invalid cron expression syntax returns a 4xx error and no billing charge","Unknown or misspelled IANA timezone string causes a validation error","Count outside the allowed range (1–20) returns a validation error","Malformed JSON body results in a 400 parse error","Network timeouts on the $0.001 x402 payment flow before the call completes"],"whenToPreferThis":"Use this endpoint when you need to quickly preview upcoming cron job execution times in a specific timezone without setting up a full scheduling library. It is ideal for validating a new cron expression before deploying it, or for displaying next-run information to end users. It supports both 5-field and 6-field cron syntax and handles IANA timezone conversion natively, making it preferable to local parsing libraries when timezone accuracy matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:30:17.195Z","isFirstParty":false}