Enumerate the next N scheduled occurrences

Given a cron expression and an optional starting datetime + IANA timezone, returns the next N scheduled occurrences. Each occurrence is reported in both local (tz-aware) and UTC forms so DST handling is explicit. Max count is 1000.

post/v1/cron/next

Request

Base URL: https://api.snipget.ai (the document declares no server; this is the origin it was published from)
URL: https://api.snipget.ai/v1/cron/next
Auth: none declared

Query parameters

include_receiptboolean

Set true to attach an execution receipt at meta.receipt — caller-verifiable sha256 hashes over the RFC 8785 (JCS) canonicalization of this call's as-received JSON body and its result (free, like include_trace). Reproduce with any JCS library: input_hash = sha256(jcs({"tool": <request path>, "args": <your body minus include_trace/include_receipt>})); result_hash = sha256(jcs(result)). For deterministic tools, same input on the same build reproduces result_hash.

Headers

authorizationstring nullable

X-API-Keystring nullable

Request body

expressionstring required

countinteger

How many future occurrences to return.

from_datetimestring nullable

ISO 8601 datetime to start iteration from. If omitted, uses now in the specified timezone. Naive datetimes are interpreted in tz.

tzstring

IANA timezone name, e.g. 'America/New_York'.

include_traceboolean

Response

Successful Response

statusstring

confidencenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.