Support: support@tinplate.dev · Zero-Retention Edge Security Support Trust Center DPA GitHub Issues
Compliance & Business Tier 2 All-Access

Working Days & Public Holiday Calculator API — EU, US & Hungarian Bridge Days

Calculate business days and SLA deadlines across 30+ countries including HU swap Saturdays. Calculate business days between dates, add working days for SLA deadlines, and check public holidays including Hungarian Saturday workdays (munkarend változás).

Additional endpoints in this module: POST /v1/workday-holiday/add, POST /v1/workday-holiday/is-workday

Interactive Sandbox · No API Key Required 200 OK · Ready
POST /v1/workday-holiday/betweeninput
200 OK sample / live responsejson
{
  "ok": true,
  "data": {
    "start_date": "2026-08-17",
    "end_date": "2026-08-24",
    "country": "HU",
    "total_days": 8,
    "working_days": 4,
    "weekend_days": 2,
    "holiday_days": 2,
    "holidays_in_range": [
      {
        "date": "2026-08-20",
        "name": "State Foundation Day",
        "type": "public"
      },
      {
        "date": "2026-08-21",
        "name": "Bridge rest day (St. Stephen's Day)",
        "type": "bridge_rest"
      }
    ],
    "workday_adjustments": [
      {
        "date": "2026-08-21",
        "kind": "bridge_rest",
        "name": "Bridge rest day (St. Stephen's Day)"
      }
    ]
  },
  "meta": {
    "request_id": "req_whd_01",
    "ms": 1
  }
}
OpenAPI 3.0.3 Get All-Access Key ($29/mo) No signup. No payload storage.
Quickstart Code Examples
curl -X POST "https://api.tinplate.dev/v1/workday-holiday/between" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TINPLATE_KEY" \
  -d '{"country":"HU","start_date":"2026-08-17","end_date":"2026-08-24"}'
import { TinplateClient } from "@tinplate/sdk";

const tinplate = new TinplateClient({
  apiKey: process.env.TINPLATE_API_KEY!,
});

const { data, meta } = await tinplate.call("/v1/workday-holiday/between", {
  "country": "HU",
  "start_date": "2026-08-17",
  "end_date": "2026-08-24"
});
console.log(`[${meta.ms} ms]`, data);
import requests

response = requests.post(
    "https://api.tinplate.dev/v1/workday-holiday/between",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_TINPLATE_KEY",
    },
    json={
  "country": "HU",
  "start_date": "2026-08-17",
  "end_date": "2026-08-24"
}
)
print(response.json())
const response = await fetch("https://api.tinplate.dev/v1/workday-holiday/between", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer YOUR_TINPLATE_KEY",
  },
  body: JSON.stringify({
  "country": "HU",
  "start_date": "2026-08-17",
  "end_date": "2026-08-24"
}),
});
const result = await response.json();
console.log(result);
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "tinplate_workday_holiday",
    "arguments": {
      "country": "HU",
      "start_date": "2026-08-17",
      "end_date": "2026-08-24"
    }
  }
}
OpenAPI 3.0.3 Schema Contract

Request Parameters & Response Schema Reference

Request Body Parameters (POST /v1/workday-holiday/between)

ParameterType & ConstraintsDescription
start_date required string Field 'start_date'
end_date required string Field 'end_date'
country required "HU" | "DE" | "GB" | "US" | "FR" | "ES" | "IT" | "NL" | "AT" | "PL" | "RO" | "SK" | "CZ" ISO 3166-1 alpha-2 country code.
include_start optional boolean Field 'include_start'
include_end optional boolean Field 'include_end'

Response data Object Fields (200 OK)

FieldTypeDescription
start_date string Field 'start_date'
end_date string Field 'end_date'
country "HU" | "DE" | "GB" | "US" | "FR" | "ES" | "IT" | "NL" | "AT" | "PL" | "RO" | "SK" | "CZ" ISO 3166-1 alpha-2 country code.
total_days integer Field 'total_days'
working_days integer Field 'working_days'
weekend_days integer Field 'weekend_days'
holiday_days integer Field 'holiday_days'
holidays_in_range object[] Field 'holidays_in_range'
workday_adjustments object[] Field 'workday_adjustments'
warnings string[] Field 'warnings'

What Workday & Holiday Calculator API Detects & Validates

  • 3 endpoints: /between (count business days), /add (calculate SLA target date), and /is-workday (check single date)
  • Computes movable Christian holidays (Easter, Good Friday, Whit Monday, Corpus Christi) algorithmically
  • Includes official Hungarian ministerial swap days (áthelyezett pihenőnapok és ledolgozós szombatok)
  • Supports custom company blackouts and custom weekend definitions (e.g. Fri/Sat vs Sat/Sun)
Honest Engineering Boundaries

Known Limitations & Test Verification

Release: v1.0.39 · Verified: 16 November 2026 · Portfolio Median: 0.318 ms in-Worker V8 compute (add 15–65 ms HTTPS RTT) · See Full Portfolio Benchmarks →

  • Hungarian swap Saturdays are published by decree each autumn for the following calendar year; data is verified through 2026–2027.
  • Tested v1.0.4 (14 November 2026).

Direct All-Access & Marketplace Plans

Direct Polar All-Access Keys unlock all 42 APIs (49 endpoints), /v1/pipeline, and /mcp on api.tinplate.dev: Pro ($29/mo · 120 req/min · 100k/mo · 128 KB) or Team ($79/mo · 300 req/min · 500k/mo · 256 KB).

PlanMonthly PriceIncluded RequestsRate LimitMax PayloadBest For
BASIC$0.00 / mo500 / month10 req / min64 KBEvaluation & CI smoke tests
PRO$9.99 / mo15,000 / month60 req / min128 KBSolo devs & production apps
ULTRA$29.99 / mo100,000 / month300 req / min256 KBGrowing SaaS & multi-agent pipelines
MEGA$79.99 / mo500,000 / month1,000 req / min256 KBHigh-volume enterprise workloads

Frequently Asked Questions

Why do standard holiday APIs fail on Hungarian business days?

Hungary decrees 'bridge days' (pihenőnap) when a holiday falls on a Tuesday or Thursday, compensated by working on a designated Saturday (ledolgozós szombat). Most global APIs ignore working Saturdays.

Can I add N business days to an invoice issue date to get the payment due date?

Yes, call POST /v1/workday-holiday/add with start_date and days: 15 (or negative days to count backward).

Which countries are supported?

All EU member states (HU, DE, AT, FR, NL, PL, RO, SK, CZ, ES, IT, etc.), UK, US, CA, CH, NO, and AU.

Zero Payload Logging

Data Handling, Privacy & Proxy Disclosure

Pure deterministic calendar calculation in memory.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Requests via RapidAPI or Zyla traverse marketplace proxies; use a Direct Bearer Key for zero-intermediary routing.

Related Tinplate APIs

POST /v1/hu-business-validator Compliance & Business

Hungarian Business Document & NAV Validator API

Validate Hungarian adószám, cégjegyzékszám, GIRO bank accounts, and NAV invoice rules.

POST /v1/ics-sanitizer Developer Utilities

ICS / iCalendar Feed Sanitizer & Validator API

Repair broken .ics calendar feeds, normalize Windows timezones to IANA, and parse VEVENTs.

POST /v1/eu-vat-iban/iban Live

EU VAT & IBAN/BIC Validator API

Validate IBANs, BIC/SWIFT codes, and EU/UK VAT numbers with live EU VIES lookup.