Ir al contenido
GET /v1/holidays

Public holidays for a country + year

Pruébalo en vivo

10 llamadas gratis al día — sin registro, sin clave API. Pasa por el gateway de oanor.

Encabezados personalizados (opcional)
api.oanor.com/holidays-api

Funciona. Consigue una clave API y úsala en tu proyecto.

Obtener una clave API

Fragmentos de código

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_..."}
)

Respuesta de ejemplo

Una respuesta real de este endpoint, capturada en la última comprobación de estado.

{
    "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",
                "
…