Official public holidays by country and year, with regional subdivisions, locali
Official public holidays by country and year, with regional subdivisions, localized names and normalized dates.
Answeringour last check, 2026-09-24
1 of 1checks answered this week
619 msmedian answer time
$0.005listed price per call
$0.005price 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
GET https://holidays.use.x402atlas.com/list
| Category | Everything else |
|---|---|
| Provider host | holidays.use.x402atlas.com |
| Networks | eip155:137, eip155:42161, eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 3 from 2 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.005 | 619 ms |
Example input (from the provider)
{
"method": "GET",
"queryParams": {
"country": "DE",
"language": "EN",
"subdivision": "DE-BE",
"year": 2026
},
"type": "http"
}
Promised output schema (from the provider)
{
"$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"
}