Calendarific
Worldwide Holidays
Calendarific provides a comprehensive API for worldwide public, bank, and religious holidays across 230+ countries. You can query holidays by country, year, type (national, religious, observance), and date range. The data covers 19 years of historical holidays and upcoming dates.
For OpenClaw agents, Calendarific is useful for timezone-aware scheduling and cultural context. Your agent can check if today is a holiday before scheduling meetings, send holiday greetings, or factor in public holidays when planning project timelines — especially valuable for globally distributed work.
Tags: calendar, scheduling
Category: Calendar
Use Cases
- Check for upcoming holidays before scheduling meetings or deadlines
- Send proactive holiday greetings via Telegram on public holidays
- Factor in country-specific holidays when planning sprint timelines for distributed teams
Tips
- Cache holiday data locally since holidays don't change frequently — saves API calls
- Use the type parameter to filter by national, religious, or observance holidays
- Combine with Google Calendar API to auto-block holidays in your calendar
Known Issues & Gotchas
- Free tier is limited to English and single language — no localized holiday names
- Dataset updates quarterly on free/starter plans — very recent holiday changes may lag
- Attribution is required on the free plan
Frequently Asked Questions
How many countries does Calendarific cover?
Calendarific covers 230+ countries and territories with national, local, religious, and observance holidays. Data quality varies by country but major markets are well covered.
Is the free tier sufficient for personal OpenClaw use?
Yes, 500 requests/month is plenty for checking holidays a few times a day. A daily holiday check uses ~30 requests/month, well within the free tier.
Does it support multiple languages?
The free tier supports English only. Paid plans (Starter+) support national languages for holiday names and descriptions.