Calendar Feeds
Subscribe to public holiday calendar feeds in ICS format. Add holidays for any country directly to Apple Calendar, Google Calendar, Outlook, or any app that supports iCalendar subscriptions.
Popular Countries
/api/v1/calendar/US.ics /api/v1/calendar/GB.ics /api/v1/calendar/DE.ics /api/v1/calendar/FR.ics /api/v1/calendar/TR.ics /api/v1/calendar/CA.ics /api/v1/calendar/AU.ics /api/v1/calendar/IN.ics /api/v1/calendar/BR.ics /api/v1/calendar/JP.ics /api/v1/calendar/ES.ics /api/v1/calendar/IT.ics How to Subscribe
Apple Calendar (macOS / iOS)
- Copy the feed URL above
- Open Apple Calendar
- Go to File > New Calendar Subscription
- Paste the URL and click Subscribe
- Set auto-refresh to "Every day" and click OK
On iOS: go to Settings > Calendar > Accounts > Add Account > Other > Add Subscribed Calendar, then paste the URL.
Google Calendar
- Copy the feed URL above
- Open Google Calendar
- Click the + next to "Other calendars"
- Select From URL
- Paste the URL and click Add calendar
Google Calendar may take up to 24 hours to sync new subscriptions.
Microsoft Outlook
- Copy the feed URL above
- Open Outlook and go to Calendar
- Click Add calendar > Subscribe from web
- Paste the URL, give it a name, and click Import
In Outlook desktop: File > Account Settings > Internet Calendars > New, then paste the URL.
URL Format Reference
| Parameter | Required | Description |
|---|---|---|
country (path) | Yes | ISO 3166-1 alpha-2 country code (e.g. US, GB, DE) |
year | No | Year (2024-2030). Defaults to current year. |
lang | No | Language code: en, tr, de, es, fr, pt. Defaults to en. |
Example: /api/v1/calendar/DE.ics?year=2026&lang=de returns German holidays in 2026 with German-language names.
Frequently Asked Questions
What is an ICS calendar feed?
ICS (iCalendar) is a universal calendar file format supported by Apple Calendar, Google Calendar, Outlook, and most other calendar applications. An ICS feed URL allows your calendar app to import and display events automatically.
How do I subscribe to a holiday calendar feed?
Copy the ICS feed URL for your country, then add it as a calendar subscription in your calendar app. See the step-by-step instructions above for Apple Calendar, Google Calendar, and Outlook.
Which countries are available?
Calendar feeds are available for over 190 countries. Use the ISO 3166-1 alpha-2 country code in the URL (e.g. US for United States, DE for Germany, JP for Japan).
Can I get holidays in my language?
Yes. Add a lang parameter to the URL. Supported languages: English (en), Turkish (tr), German (de), Spanish (es), French (fr), and Portuguese (pt).
Is the calendar feed free?
Yes, all calendar feeds are completely free to use. No registration or API key is required.
Can I use the .ics extension in the URL?
Yes. Both /api/v1/calendar/US and /api/v1/calendar/US.ics work identically. The .ics extension is stripped automatically.