Official public holidays by country and year, with regional subdivisions, localized names
Official public holidays by country and year, with regional subdivisions, localized names and normalized dates.
5000 (raw units)
price
3
calls / 30d
2
unique payers
2026-09-15
updated
Provider
holidays.use.x402atlas.com · discovered, not yet claimed by its owner
Payment (x402 accepts[])
[
{
"scheme": "exact",
"network": "eip155:8453",
"payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
"asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
"amount": "5000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:137",
"payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
"asset": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
"amount": "5000",
"maxTimeoutSeconds": 300
},
{
"scheme": "exact",
"network": "eip155:42161",
"payTo": "0x8C128f1Ee62Bb5e47867CfbAe2ad89be325Df1b2",
"asset": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831",
"amount": "5000",
"maxTimeoutSeconds": 300
}
]Output schema
{
"bazaar": {
"category": "calendar",
"info": {
"input": {
"method": "GET",
"queryParams": {
"country": "DE",
"language": "EN",
"subdivision": "DE-BE",
"year": 2026
},
"type": "http"
},
"output": {
"example": {
"count": 1,
"country": "DE",
"holidays": [
{
"end_date": "2026-01-01",
"name": "New Year's Day",
"nationwide": true,
"regional_scope": "National",
"start_date": "2026-01-01",
"subdivisions": [],
"temporal_scope": "FullDay",
"type": "Public"
}
],
"language": "EN",
"queried_at": "2026-07-27T12:00:00Z",
"subdivision": "DE-BE",
"year": 2026
},
"type": "json"
}
},
"schema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"method": {
"enum": [
"GET"
],
"type": "string"
},
"queryParams": {
"properties": {
"country": {
"description": "Supported ISO 3166-1 alpha-2 country code: AD Andorra; AL Albania; AT Austria; BE Belgium; BG Bulgaria; BR Brazil; BY Belarus; CH Switzerland; CZ Czechia; DE Germany; EE Estonia; ES Spain; FR France; HR Croatia; HU Hungary; IE Ireland; IT Italy; LI Liechtenstein; LT Lithuania; LU Luxembourg; LV Latvia; MC Monaco; MD Moldova; MT Malta; MX Mexico; NL Netherlands; PL Poland; PT Portugal; RO Romania; RS Serbia; SE Sweden; SI Slovenia; SK Slovakia; SM San Marino; VA Vatican City; ZA South Africa.",
"enum": [
"AD",
"AL",
"AT",
"BE",
"BG",
"BR",
"BY",
"CH",
"CZ",
"DE",
"EE",
"ES",
"FR",
"HR",
"HU",
"IE",
"IT",
"LI",
"LT",
"LU",
"LV",
"MC",
"MD",
"MT",
"MX",
"NL",
"PL",
"PT",
"RO",
"RS",
"SE",
"SI",
"SK",
"SM",
"VA",
"ZA"
],
"type": "string"
},
"language": {
"description": "Optional two-letter ISO 639-1 result language. Defaults to English when available.",
"pattern": "^[A-Z]{2}$",
"type": "string"
},
"subdivision": {
"description": "Optional regional subdivision code beginning with the selected country code, for example DE-BE.",
"maxLength": 20,
"pattern": "^[A-Z]{2}-.+$",
"type": "string"
},
"year": {
"description": "Calendar year",
"maximum": 2030,
"minimum": 2020,
"type": "integer"
}
},
"required": [
"country",
"year"
],
"type": "object"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"properties": {
"count": {
"type": "integer"
},
"country": {
"type": "string"
},
"holidays": {
"items": {
"properties": {
"end_date": {
"format": "date",
"type": "string"
},
"name": {
"description": "Holiday name in the requested language when available",
"type": "string"
},
"nationwide": {
"type": "boolean"
},
"regional_scope": {
"enum": [
"National",
"Regional",
"Local"
],
"type": "string"
},
"start_date": {
"format": "date",
"type": "string"
},
"subdivisions": {
"items": {
"type": "string"
},
"type": "array"
},
"temporal_scope": {
"enum": [
"FullDay",
"HalfDay"
],
"type": "string"
},
"type": {
"enum": [
"Public",
"Bank",
"Optional",
"School",
"BackToSchool",
"EndOfLessons"
],
"type": "string"
}
},
"required": [
"name",
"start_date",
"end_date",
"type",
"nationwide",
"subdivisions"
],
"type": "object"
},
"type": "array"
},
"language": {
"type": "string"
},
"queried_at": {
"format": "date-time",
"type": "string"
},
"subdivision": {
"type": "string"
},
"year": {
"type": "integer"
}
},
"required": [
"country",
"year",
"queried_at",
"count",
"holidays"
],
"type": "object"
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
},
"tags": [
"public-holidays",
"official-holidays",
"country-calendar",
"regional-holidays",
"bank-holidays",
"scheduling"
]
}
}Use it
curl
curl "https://holidays.use.x402atlas.com/list" # -> 402 Payment Required, accepts[] lists how to pay # retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid
JavaScript
const res = await fetch("https://holidays.use.x402atlas.com/list");
if (res.status === 402) {
const { accepts } = await res.json();
// pay one of accepts[] via an x402 client, then retry with the payment header
}Python
import httpx
res = httpx.get("https://holidays.use.x402atlas.com/list")
if res.status_code == 402:
accepts = res.json()["accepts"]
# pay one of accepts[] via an x402 client, then retry with the payment headerMachine-readable
Everything on this page is also available as clean JSON at /resources/1378.json, and this resource appears in /discovery/resources and /discovery/search.