Public holidays for ~200 countries and their subdivisions, plus business-day ari
Public holidays for ~200 countries and their subdivisions, plus business-day arithmetic: is this date a holiday or business day, next business day, add N business days, count business days between dates. Configurable weekend and holiday types.
Answeringour last check, 2026-09-24
1 of 1checks answered this week
565 msmedian answer time
$0.002listed price per call
$0.002price it asked us
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://workbot1.oddsys.org/holidays
| Category | Everything else |
|---|---|
| Provider host | workbot1.oddsys.org |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 1 from 1 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.002 | 565 ms |
Example input (from the provider)
{
"body": {
"country": "US",
"days": 3,
"from": "2026-12-24"
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"country": {
"description": "2-letter ISO country code (required).",
"type": "string"
},
"date": {
"description": "YYYY-MM-DD \u2014 is this date a holiday / business day, and the next business day.",
"type": "string"
},
"days": {
"description": "Add this many business days to from (negative to subtract).",
"type": "integer"
},
"from": {
"description": "YYYY-MM-DD start date for days/to modes.",
"type": "string"
},
"region": {
"description": "Sub-subdivision code where the ruleset has one.",
"type": "string"
},
"state": {
"description": "Subdivision code (e.g. CA for US-California, NSW for AU).",
"type": "string"
},
"to": {
"description": "YYYY-MM-DD \u2014 count business days in [from, to] and list holidays inside.",
"type": "string"
},
"types": {
"description": "Holiday types that block a business day (default [public]).",
"items": {
"enum": [
"public",
"bank",
"school",
"optional",
"observance"
],
"type": "string"
},
"type": "array"
},
"weekend": {
"description": "Weekend weekdays 0=Sunday\u20266=Saturday (default [0,6]).",
"items": {
"type": "integer"
},
"type": "array"
},
"year": {
"description": "List all holidays in this year (default: current year) when no date/from is given.",
"type": "integer"
}
},
"required": [
"country"
],
"type": "object"
},
"bodyType": {
"enum": [
"json"
],
"type": "string"
},
"method": {
"enum": [
"POST"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
}
}
}