Holiday-aware business-day calculator for 200+ countries.
Holiday-aware business-day calculator for 200+ countries. Three modes: pass start + addDays (signed integer) to shift a date by N business days; pass start + end to count business days between two dates (exclusive of start, inclusive of end); pass start alone to check one date (is it a business day, which holiday, next/previous business day). Query: country (ISO 3166-1 alpha-2), start (YYYY-MM-DD), optional region (subdivision code), addDays XOR end, optional weekend (comma-separated days, default sat,sun — e.g. fri,sat for the Gulf), optional types (holiday types treated as closures, default public,bank). Skipped holidays are itemized in the response. Use for payment terms, SLA deadlines, and delivery-date math.
Request
- Base URL: https://2s.io
- URL: https://2s.io/api/calendar/business-days
- Auth: API key in header PAYMENT-SIGNATURE
Query parameters
ISO 3166-1 alpha-2 country code, e.g. US, DE, JP.
Anchor date, YYYY-MM-DD.
Signed number of business days to add to start (non-zero, ±3660). Mutually exclusive with end.
End date YYYY-MM-DD. Counts business days after start through end. Mutually exclusive with addDays.
Optional subdivision code — e.g. CA for US-California, BY for DE-Bavaria.
Optional comma-separated weekend days (mon..sun). Default "sat,sun"; use "fri,sat" for Gulf states.
Optional comma-separated holiday types treated as business closures (public, bank, school, optional, observance). Default "public,bank".
Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.
Response
Changes
No recorded changes to this operation across all 1 revision of this API.