/v1/holidays
Public holidays for a country + year
Essayez-le en direct
10 appels gratuits par jour — sans inscription, sans clé API. Passe par la passerelle oanor.
Ça marche. Récupérez une clé API et utilisez-la dans votre projet.
Obtenez une clé APIExtraits de code
curl "https://api.oanor.com/holidays-api/v1/holidays" \ -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/holidays-api/v1/holidays", {
headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/holidays-api/v1/holidays");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
"https://api.oanor.com/holidays-api/v1/holidays",
headers={"x-oanor-key": "oanor_test_..."}
)
Exemple de réponse
Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.
{
"data": {
"year": 2026,
"count": 19,
"country": "DE",
"holidays": [
{
"date": "2026-01-01",
"name": "New Year's Day",
"types": [
"Public"
],
"global": true,
"country": "DE",
"counties": null,
"local_name": "Neujahr",
"launch_year": null
},
{
"date": "2026-01-06",
"name": "Epiphany",
"types": [
"Public"
],
"global": false,
"country": "DE",
"counties": [
"DE-BW",
"DE-BY",
"DE-ST"
],
"local_name": "Heilige Drei Könige",
"launch_year": null
},
{
"date": "2026-03-08",
"name": "International Women's Day",
"types": [
"Public"
],
"global": false,
"country": "DE",
"counties": [
"DE-BE",
"DE-MV"
],
"local_name": "Internationaler Frauentag",
"launch_year": null
},
{
"date": "2026-04-03",
"name": "Good Friday",
"types": [
"Public"
],
"global": true,
"country": "DE",
"counties": null,
"local_name": "Karfreitag",
"launch_year": null
},
{
"date": "2026-04-05",
"name": "Easter Sunday",
"types": [
"Public"
],
"global": false,
"country": "DE",
"counties": [
"DE-BB"
],
"local_name": "Ostersonntag",
"launch_year": null
},
{
"date": "2026-04-06",
"name": "Easter Monday",
"types": [
"Public"
],
"global": true,
"country": "DE",
"counties": null,
"local_name": "Ostermontag",
"launch_year": null
},
{
"date": "2026-05-01",
"name": "Labour Day",
"types": [
"Public"
],
"global": true,
"country": "DE",
"counties": null,
"local_name": "Tag der Arbeit",
"launch_year": null
},
{
"date": "2026-05-14",
"name": "Ascension Day",
"
…