calendarific.com

What it is

Calendarific is a global holidays RESTful API that provides developers and businesses with holiday data covering national, local/regional, religious, and observance days. Its site states that it covers 230+ countries and 3,000+ states/regions, while the About page claims support for 100+ languages and 50,000+ customers. It is positioned for use cases such as finance, banking, education, travel, supply chain, HR, and workforce scheduling.

Core capabilities

The Base URL for API v2 is https://calendarific.com/api/v2, with core endpoints including /holidays, /countries, and /languages. Requests require authentication via api_key and must use HTTPS. The /holidays endpoint requires country, year, and api_key parameters, and can be filtered by day, month, location, and type; supported types include national, local, religious, and observance. Paid advanced parameters include language and uuid. The API returns JSON and supports JSONP/CORS, making it suitable for integration with websites, mobile apps, and backend services. We did not find official SDK, self-hosting, or open-source information, so it is best understood as a pure SaaS data API.

Pricing and support

Pricing uses a free tier plus subscription plans. Free includes 500 calls/month, requires attribution, offers community support, supports a single language, and provides limited data. Starter costs $12/month or $100/year and includes 10,000 calls/month plus email support. Business costs $500/year and includes 50,000 calls/month, priority support, all languages, and weekly updates. Enterprise costs $4,000/year and includes 50,000,000 calls/month, dedicated support, and daily updates. Custom enterprise quotes, invoicing, and technical account support are also available. Note that the documentation also states a free API limit of 1,000 requests/day, which conflicts with the pricing page’s 500 calls/month; this should be confirmed before purchasing.

Pros and cons

The main advantages are broad coverage, straightforward REST parameters, documentation with examples, status codes and error codes, and CORS/JSONP support, making integration easy for both frontend and backend use. Downsides include a relatively low free quota with attribution required, subscription restrictions on advanced language and UUID parameters, no official SDK or self-hosted option, and a no-refund policy for advanced subscriptions, which increases trial risk.

Who it’s for and access from China

Calendarific is suitable for teams that need reliable holiday data for multinational apps, scheduling systems, HR, financial trading-day logic, travel calendars, and supply chain planning. The available text does not describe access from China, so domain connectivity, Stripe payment availability, and invoicing requirements should be tested before production use. If you need an open-source or self-hostable alternative, consider evaluating Nager.Date; if you only need a commercial API, you can also compare Abstract Public Holidays API, Timeanddate API, and HolidayAPI.