Compliance & Business Tier 2 Ready POST /v1/workday-holiday/between

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

Try It Live in Your Browser · No API Key Required

1. Interactive Sandbox & Sample JSON Output

200 OK · Ready

Editable Request JSON (`POST /v1/workday-holiday/between`)

Live 200 OK Response Envelope

{
  "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
  }
}

Get API Key on RapidAPI Get API Key on Zyla Hub Download OpenAPI 3.0.3 Spec

2. Quickstart Code Examples

Full TypeScript & Python SDK →

curl -X POST "https://api.tinplate.dev/v1/workday-holiday/between" \
  -H "Content-Type: application/json" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -d '{"country":"HU","start_date":"2026-08-17","end_date":"2026-08-24"}'

import { TinplateClient } from "@tinplate/sdk"; // npm install @tinplate/sdk

const tinplate = new TinplateClient({
  rapidApiKey: process.env.RAPIDAPI_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",
        "X-RapidAPI-Key": "YOUR_RAPIDAPI_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",
    "X-RapidAPI-Key": "YOUR_RAPIDAPI_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`)

Parameter	Type & Constraints	Description
`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`)

Field	Type	Description
`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'

3. 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

4. Known Limitations & Test Verification

Release Version: v1.0.7 · Last Verified / Benchmarked: 14 November 2026 · Latency Note: Sub-millisecond figures measure in-Worker V8 compute time (typical client HTTPS network RTT to the nearest Cloudflare PoP is 15–65 ms) · See Full Portfolio Benchmarks & Corpora →

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).

5. Marketplace Plans & Payload Quotas

Plan	Monthly Price	Included Requests	Rate Limit	Max Request Payload	Best For
BASIC	$0.00 / month	500 / month (hard limit)	10 req / min	64 KB	Evaluation, local development & CI smoke tests
PRO	$9.99 / month	15,000 / month	60 req / min	128 KB	Solo developers & production apps
ULTRA	$29.99 / month	100,000 / month	300 req / min	256 KB	Growing SaaS & multi-agent pipelines
MEGA	$79.99 / month	500,000 / month	1,000 req / min	256 KB	High-volume enterprise workloads

Subscribe on RapidAPI Subscribe on Zyla Hub Full Pricing Details

6. 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

7. Data Handling, Privacy & Marketplace Proxy Disclosure

Pure deterministic calendar calculation in memory.

Worker Zero-Logging Guarantee: Cloudflare Workers Observability and invocation logging are disabled in configuration (observability.enabled = false, head_sampling_rate = 0, invocation_logs = false). Payloads are processed strictly in volatile V8 memory and never logged or stored by Tinplate.

Marketplace Proxies vs. Direct Bearer Key: Requests sent via RapidAPI or Zyla API Hub pass through those marketplaces' proxy infrastructure (subject to their respective privacy policies). Security-sensitive workloads requiring end-to-end zero-intermediary processing can connect directly to https://api.tinplate.dev using a Direct Bearer Key (Authorization: Bearer <API_KEY>). Read our full Privacy Notice and OpenAPI 3.0.3 JSON Schema.