Business days between two dates, or the date N business days from a date

Span mode: from + to. Add mode: date (default today) + days (+ dir=from|before). Both modes accept cal (jurisdiction), custom (comma-separated ISO dates, mutually exclusive with cal), ww (workweek: mon-fri, sun-thu, mon-sat), tz. When a holiday calendar is in play (cal or custom), the span between from and to is limited to 100000 days; resolving a jurisdiction's rules is per-year work, so a centuries-wide holiday span is refused with out_of_range. Without a calendar the full 1600-3000 year range is accepted.

get/api/v1/business-days

Request

  • Base URL: https://tilwhen.com
  • URL: https://tilwhen.com/api/v1/business-days
  • Auth: none declared

Query parameters

fromstring

Strict ISO YYYY-MM-DD, or the literal "today" (resolved in tz).

tostring

Strict ISO YYYY-MM-DD, or the literal "today" (resolved in tz).

datestring

Strict ISO YYYY-MM-DD, or the literal "today" (resolved in tz).

daysinteger
dir'from' | 'before'
cal'US' | 'GB' | 'GB-SCT' | 'GB-NIR' | 'CA' | 'AU' | 'UG' | 'UK'

Holiday jurisdiction (ISO 3166-1/-2; UK is a legacy alias for GB).

customstring

Comma-separated ISO dates (max 1000): a custom organizational holiday calendar.

ww'mon-fri' | 'sun-thu' | 'mon-sat'
tzstring

IANA timezone name; defaults to UTC.

Example:Africa/Kampala

Response

The answer plus its auditable receipt

answerobject required

Changes

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