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 accessPricing ↗

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.

Inputs

  • 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 operators; 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

Requirements

  • 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