{"openapi":"3.2.0","info":{"title":"Czech Name Days and Holidays API","description":"Jmeniny (svátky) v Česku a na Slovensku + české státní svátky a významné dny. Jednoduché REST API se všemi 365 dny.","version":"1.0.0"},"servers":[{"url":"https://bckul.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"x-agent-commerce":{"catalog_url":"https://bckul.jojapi.net/_jojapi/agent/plans","discovery_url":"https://bckul.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/czech-name-days-and-holidays","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/today":{"get":{"operationId":"get_today","summary":"Today","description":"Dnešní svátky (CZ + SK) + české státní svátky a významné dny","responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"date":"1.9.","day":1,"month":9,"month_name_cz":"září","month_name_en":"September","names_cz":["Linda"],"names_sk":["Drahoslava","Egid"],"holidays":[]}}}}}}},"/search":{"get":{"operationId":"get_search","summary":"Search","description":"Najdi kdy má jméno svátek (CZ + SK)","responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"query":"Tamara","found":true,"cz":[{"day":3,"month":6}],"sk":[{"day":25,"month":1}]}}}}},"parameters":[{"name":"name","in":"query","required":false,"schema":{"type":"string"}}]}},"/holidays":{"get":{"operationId":"get_holidays","summary":"Holidays","description":"Všechny české státní svátky a významné dny","responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"year":2026,"total":34,"fixed_count":32,"movable_count":2,"holidays":[{"date":"1.1.","day":1,"month":1,"name":"Den obnovy samostatného českého státu","type":"státní svátek","type_en":"state holiday"},{"date":"8.5.","day":8,"month":5,"name":"Den vítězství","type":"státní svátek","type_en":"state holiday"}]}}}}}}},"/holidays/{year}":{"get":{"operationId":"get_holidays_year","summary":"Holidays by Year","description":"Svátky pro konkrétní rok","responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"year":2026,"total":34,"fixed_count":32,"movable_count":2,"holidays":[{"date":"1.1.","day":1,"month":1,"name":"Den obnovy samostatného českého státu","type":"státní svátek","type_en":"state holiday"},{"date":"8.5.","day":8,"month":5,"name":"Den vítězství","type":"státní svátek","type_en":"state holiday"},{"date":"5.7.","day":5,"month":7,"name":"Den slovanských věrozvěstů Cyrila a Metoděje","type":"státní svátek","type_en":"state holiday"},{"date":"6.7.","day":6,"month":7,"name":"Den upálení mistra Jana Husa","type":"státní svátek","type_en":"state holiday"},{"date":"28.9.","day":28,"month":9,"name":"Den české státnosti","type":"státní svátek","type_en":"state holiday"},{"date":"28.10.","day":28,"month":10,"name":"Den vzniku samostatného československého státu","type":"státní svátek","type_en":"state holiday"},{"date":"17.11.","day":17,"month":11,"name":"Den boje za svobodu a demokracii a Mezinárodní den studentstva","type":"státní svátek","type_en":"state holiday"},{"date":"1.1.","day":1,"month":1,"name":"Nový rok","type":"ostatní svátek","type_en":"other holiday"},{"date":"movable","day":null,"month":null,"name":"Velký pátek","type":"ostatní svátek","type_en":"other holiday","note":"Movable — between 20 March and 23 April"},{"date":"movable","day":null,"month":null,"name":"Velikonoční pondělí","type":"ostatní svátek","type_en":"other holiday","note":"Movable — between 23 March and 26 April"},{"date":"1.5.","day":1,"month":5,"name":"Svátek práce","type":"ostatní svátek","type_en":"other holiday"},{"date":"24.12.","day":24,"month":12,"name":"Štědrý den","type":"ostatní svátek","type_en":"other holiday"},{"date":"25.12.","day":25,"month":12,"name":"1. svátek vánoční","type":"ostatní svátek","type_en":"other holiday"},{"date":"26.12.","day":26,"month":12,"name":"2. svátek vánoční","type":"ostatní svátek","type_en":"other holiday"},{"date":"16.1.","day":16,"month":1,"name":"Den památky Jana Palacha","type":"významný den","type_en":"significant day"},{"date":"27.1.","day":27,"month":1,"name":"Den památky obětí holocaustu a předcházení zločinům proti lidskosti","type":"významný den","type_en":"significant day"},{"date":"8.3.","day":8,"month":3,"name":"Mezinárodní den žen","type":"významný den","type_en":"significant day"},{"date":"9.3.","day":9,"month":3,"name":"Den památky obětí vyhlazení terezínského rodinného tábora v Osvětimi-Březince","type":"významný den","type_en":"significant day"},{"date":"12.3.","day":12,"month":3,"name":"Den přístupu České republiky k Severoatlantické smlouvě (NATO)","type":"významný den","type_en":"significant day"},{"date":"28.3.","day":28,"month":3,"name":"Den narození Jana Ámose Komenského","type":"významný den","type_en":"significant day"},{"date":"30.3.","day":30,"month":3,"name":"Den české vlajky","type":"významný den","type_en":"significant day"},{"date":"7.4.","day":7,"month":4,"name":"Den vzdělanosti","type":"významný den","type_en":"significant day"},{"date":"1.5.","day":1,"month":5,"name":"Den přistoupení České republiky k Evropské unii","type":"významný den","type_en":"significant day"},{"date":"5.5.","day":5,"month":5,"name":"Květnové povstání českého lidu","type":"významný den","type_en":"significant day"},{"date":"15.5.","day":15,"month":5,"name":"Den rodin","type":"významný den","type_en":"significant day"},{"date":"27.5.","day":27,"month":5,"name":"Den národního vzdoru","type":"významný den","type_en":"significant day"},{"date":"10.6.","day":10,"month":6,"name":"Den památky obětí vyhlazení obce Lidice","type":"významný den","type_en":"significant day"},{"date":"18.6.","day":18,"month":6,"name":"Den hrdinů druhého odboje","type":"významný den","type_en":"significant day"},{"date":"25.6.","day":25,"month":6,"name":"Den odchodu okupačních vojsk","type":"významný den","type_en":"significant day"},{"date":"27.6.","day":27,"month":6,"name":"Den památky obětí komunistického režimu","type":"významný den","type_en":"significant day"},{"date":"21.8.","day":21,"month":8,"name":"Den památky obětí invaze a následné okupace vojsky Varšavské smlouvy","type":"významný den","type_en":"significant day"},{"date":"8.10.","day":8,"month":10,"name":"Památný den sokolstva","type":"významný den","type_en":"significant day"},{"date":"12.10.","day":12,"month":10,"name":"Den samizdatu","type":"významný den","type_en":"significant day"},{"date":"11.11.","day":11,"month":11,"name":"Den válečných veteránů","type":"významný den","type_en":"significant day"}]}}}}},"parameters":[{"name":"year","in":"path","required":true,"schema":{"type":"string"}}]}},"/names":{"get":{"operationId":"get_names","summary":"All Names","description":"Kompletní seznam všech jmen s daty (CZ + SK)","responses":{"200":{"description":"Successful response","content":{"application/json":{"example":{"total_cz":366,"total_sk":709,"names_cz":[{"name":"Nový rok","day":1,"month":1,"date":"1.1."},{"name":"Karina","day":2,"month":1,"date":"2.1."}],"names_sk":[{"name":"Nový rok","day":1,"month":1,"date":"1.1."},{"name":"Alexandra","day":2,"month":1,"date":"2.1."}]}}}}}}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}