iCalendar Guide For Enrico 2.0


If you don't know what is iCalendar, learn more here. iCalendar is an RFC standard and is suitable for calendar data exchange. You can use it when you want to import holiday dates from Enrico to other application (such as Google Calendar or Apple Calendar) or to your smart phone like iPhone or Android phone. iCalendar is supported by a large number of products, including Google Calendar, Apple Calendar (formerly iCal), Yahoo! Calendar, Lightning extension for Mozilla Thunderbird, Microsoft Outlook and many more. You can use also other interfaces to get data from Enrico. When you are a software developer consider using JSON interface or soap web service interface.

Query Parameters in iCalendar URL

iCalendar URL looks like http://www.kayaposoft.com/enrico/ics/v2.0?fromDate=04-07-2022&toDate=04-07-2024&country=usa&region=dc&lang=en. The description of query parameters is following:
ParameterDescriptionMandatoryDefault Value
fromDateHoliday dates from this date on (including this date) will be returned.YesNo default value
toDateHoliday dates before this date (including this date) will be returned.YesNo default value
countryISO 3166-1 alpha-3 country code or ISO 3166-1 alpha-2 country codeYesNo default value
region Possible values for New Zealand: ISO 3166-2:NZ codes - auk, bop, can, gis, hkb, mbh, mwt, nsn, ntl, ota, stl, tas, tki, wko, wgn, wtc, cit
Possible values for Australia: ISO 3166-2:AU codes - nsw, qld, sa, tas, vic, wa, act, nt
Possible values for Canada: ISO 3166-2:CA codes - ab, bc, mb, nb, nl, ns, on, pe, qc, sk, nt, nu, yt
Possible values for United States of America: ISO 3166-2:US codes - al, ak, az, ar, ca, co, ct, de, fl, ga, hi, id, il, in, ia, ks, ky, la, me, md, ma, mi, mn, ms, mo, mt, ne, nv, nh, nj, nm, ny, nc, nd, oh, ok, or, pa, ri, sc, sd, tn, tx, ut, vt, va, wa, wv, wi, wy, dc
Possible values for Germany: ISO 3166-2:DE codes - bw, by, be, bb, hb, hh, he, mv, ni, nw, rp, sl, sn, st, sh, th
Possible values for Great Britain: ISO 3166-2:GB codes - eng, nir, sct, wls
Yes for countries New Zealand, Australia, Canada, United States of America, Germany and Great Britain.No default value
holidayType Possible values
  • all - all holiday types
  • public_holiday - public holidays
  • observance - observances, not a public holidays
  • school_holiday - school holidays
  • other_day - other important days e.g. Mother's day, Father's day etc
  • extra_working_day - extra working days. This day takes place mostly on Saturday or Sunday and is substituted for extra public holiday.
langISO 639-1 language code. Official language(s) in the country and English should be supported for every country.NoFirst non-English language or English
All data coming to and from Enrico is UTF-8 encoded.


How to Import Holiday Dates to Your Favourite Application

Enrico is powered by Kayapo