Reference · built on requestCommons signalEconomic & calendar reference

Calendarific

National, local, religious, and observance holidays for 230+ countries and 3,300+ regions, as JSON with an API key.

Request CalendarificAsk about this listing

About

Calendarific is a holiday API at calendarific.com/api/v2 covering 230+ countries and 3,300+ states and regions. Three endpoints return holidays, countries, and languages. Each holiday comes with a name, description, ISO date, one or more types, a primary type, and the locations it applies to. Types are national (public, federal, and bank holidays), local, religious, and observance. The free plan allows 500 calls a month, English names only, and requires a visible 'Powered by Calendarific' credit; paid plans raise the call limit and add languages.

An operator on Fibric pulls a country's year of holidays, filters by region or type, and proposes schedule, cutoff, or SLA adjustments for you to approve.

This is a reference listing. It documents what Fibric would read from Calendarific and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

What it reads

  • Holidays for a country and year through /holidays with api_key, country (ISO 3166-1 alpha-2), and year
  • Narrower sets through the month, day, location (ISO 3166-2), and type parameters
  • Holiday records with name, description, country, date.iso, a type array, primary_type, locations, states, canonical_url, and urlid
  • Types national, local, religious, and observance, where observance covers UN days, sporting events, seasons, and clock changes
  • Supported countries with ISO codes through /countries and language codes through /languages
  • Names and descriptions in another language through the language parameter on plans that include it

Proposed actions

Read-only. This feed informs agents; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Shift promise dates around holidays in every ship-to country

    Load the year's national holidays for each destination country, check each promised date, and propose a later promise where the date lands on a holiday. The holiday name is kept with the change.

    With Promise Date

  • Set first-response targets against the local calendar

    Filter holidays by location for each support site and propose adjusted first-response targets for tickets that arrive on a local or national holiday.

    With First Response

  • Hold dunning notices on religious and national holidays

    Check the send date for each reminder against the customer's country calendar and propose a deferral when it falls on a holiday.

    With Dunning Cadence

  • Warn staff before a regional observance

    Pull local holidays by ISO 3166-2 region and propose a schedule notice to the teams working in that region ahead of the date.

    With Schedule Notice

What it needs

  • A Calendarific account and API key; the free plan allows 500 calls a month
  • A visible 'Powered by Calendarific' credit on the free plan, in your terms, about page, or where the data is shown
  • ISO 3166-1 alpha-2 country codes and, for regional holidays, ISO 3166-2 location codes
  • A refresh routine, since the terms bar caching the data for more than thirty calendar days
Authentication
An API key from a Calendarific account, passed as the api_key query parameter over HTTPS; the free plan issues one.

Limits

  • Free-plan datasets update quarterly; weekly and daily updates are tied to the Business and Enterprise plans
  • The free plan returns English only and limited historical and upcoming years; the language parameter is ignored
  • Cached data must be refreshed or deleted within thirty days, and the data may not be redistributed or resold
  • Exceeding the monthly quota returns HTTP 429 with error_type rate_limit_exceeded

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request Calendarific

Questions and answers

What does the free plan include?
500 calls a month, English names only, limited historical and upcoming data, and quarterly dataset updates. It requires a visible 'Powered by Calendarific' credit. The Starter, Business, and Enterprise plans raise the call limit, drop the attribution requirement, and add languages.
How do I get holidays for one state or region?
Pass location with an ISO 3166-2 code alongside country and year. Each holiday in the response lists the locations and states it applies to, and regional holidays carry the type local.
Can I store the holidays I fetch?
Only for a limited time. The terms state you must not cache, store, or persist data from the API for more than thirty calendar days; after that, refresh it with a new request. Redistribution and resale of the data are not permitted.
Ask about Calendarific

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by Calendarific (calendarific.com/api/v2). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy