Kalendářové API

Bezplatné JSON API jen pro čtení: jmeniny, státní svátky, vlajkové dny, fáze Měsíce a čísla týdnů. Bez klíče a bez registrace. API odpovídá údaji kalendáře, na jehož adresu se dotazujete.

https://ceskykalendar.app/api/v1

Koncové body

GET /api/v1/today
Vše o dnešním dni.
GET /api/v1/date/2026-12-06
Konkrétní den ve tvaru RRRR-MM-DD.
GET /api/v1/name-day/Anna
Kdy má jméno svátek, letos i příští rok.

Pole odpovědi

date: Datum ve formátu ISO, RRRR-MM-DD.
weekday: Název dne v týdnu v místním jazyce.
weekNumber: Číslo týdne podle ISO 8601, 1 až 53.
nameDay: Jména, která ten den slaví svátek.
holidays: Státní svátky, každý s názvem a identifikátorem.
flagDays: Oficiální vlajkové dny, každý s názvem a identifikátorem.
moon: Fáze Měsíce a podíl osvětlené části.

Ukázková odpověď

Živá odpověď tohoto kalendáře pro dnešek:

{
  "locale": "cs",
  "date": "2026-11-05",
  "weekday": "čtvrtek",
  "weekNumber": 45,
  "nameDay": {
    "names": [
      "Miriam"
    ]
  },
  "holidays": [],
  "flagDays": [],
  "moon": {
    "phase": "waningCrescent",
    "illumination": 0.184
  }
}

Limit dotazů

Nejvýše 60 dotazů za minutu z jedné IP adresy. Odpovědi zůstávají hodinu v mezipaměti, takže většina aplikací na limit nikdy nenarazí. Po překročení limitu vrátí API kód 429 a hlavičku Retry-After.

Podmínky

Používejte zdarma v aplikacích, na webech i v projektech pro radost. Odkaz zpět na Český kalendář potěší, ale není povinný. Údaje se mohou měnit, proto berte každou odpověď jako aktuální snímek.