Calendarific

Worldwide public holidays REST API covering 230+ countries. Calendarific provides national, local, religious, and observance holiday data with localization across many ISO-639 languages. Used for ecommerce scheduling, HR systems, travel planning, payroll, and global operations.

1 APIs 7 Features

CalendarPublic APIsHolidaysWorldwideLocalization

APIs

Calendarific Holiday API

REST API returning worldwide public holidays for any of 230+ countries and any year through 2049. Supports filtering by month, day, sub-region (ISO-3166-2), holiday type, and la...

Collections

Calendarific Holiday API

OPEN

Pricing Plans

Calendarific Plans Pricing

4 plans

PLANS

Rate Limits

Calendarific Rate Limits

0 limits

RATE LIMITS

FinOps

Calendarific Finops

FINOPS

Features

230+ Countries

Coverage of national holidays across more than 230 countries.

Multi-Language Localization

Holiday names and descriptions in many ISO-639 languages (premium).

Holiday Type Filtering

Filter by national, local, religious, or observance categories.

Sub-Region Filtering

Filter by ISO-3166-2 state or region codes.

Historical and Future Data

Holidays from historical years through 2049.

CSV and XLS Export

Download holiday data as flat files in addition to API access.

Multiple API Keys

Multiple keys per account for environment separation.

Use Cases

Ecommerce Scheduling

Plan promotions, shipping cutoffs, and customer service hours around local holidays.

HR and Payroll

Populate localized leave calendars and statutory holiday pay.

Travel Planning

Surface holiday windows that affect bookings, demand, and pricing.

Workforce Scheduling

Plan global team staffing around local public holidays.

Calendar Sync

Hydrate enterprise calendars (Google, Outlook) with localized holidays.

Financial Markets

Identify country-specific trading and settlement closures.

Integrations

Google Calendar

Imported holiday data into Google Calendar via custom calendars.

Microsoft Outlook

Hydrate Outlook calendars with localized holiday events.

Home Assistant

Community Home Assistant sensor uses Calendarific as a data source.

ETL Pipelines

Community ETL examples using Python, SQLite, and Apache Airflow.

Solutions

Developer API

REST API for embedding holiday data into apps and services.

Data Downloads

CSV and XLS bulk exports for analytics and offline use.

Semantic Vocabularies

Calendarific Context

18 classes · 2 properties

JSON-LD

API Governance Rules

Calendarific API Rules

6 rules · 2 errors 4 warnings

SPECTRAL

JSON Structure

Calendarific Country Structure

5 properties

JSON STRUCTURE

Calendarific Holiday Structure

10 properties

JSON STRUCTURE

Calendarific Language Structure

2 properties

JSON STRUCTURE

Example Payloads

Calendarific List Countries Example

2 fields

EXAMPLE

Calendarific List Holidays Example

2 fields

EXAMPLE

Calendarific List Languages Example

2 fields

EXAMPLE

Resources

DeveloperPortal

DeveloperPortal

TermsOfService

PrivacyPolicy

GitHubOrganization

GitHubOrganization

SpectralRules

Sources

opencollection: 1.0.0
info:
  name: Calendarific Holiday API
  version: '2.0'
request:
  auth:
    type: apikey
    key: api_key
    value: '{{api_key}}'
    placement: query
items:
- info:
    name: Holidays
    type: folder
  items:
  - info:
      name: List Holidays
      type: http
    http:
      method: GET
      url: https://calendarific.com/api/v2/holidays
      params:
      - name: api_key
        value: ''
        type: query
        description: Calendarific API key issued via the developer console.
      - name: country
        value: ''
        type: query
        description: ISO-3166 country code (e.g., US, GB, IN).
      - name: year
        value: ''
        type: query
        description: Year to retrieve holidays for. Historical data available through 2049.
      - name: day
        value: ''
        type: query
        description: Filter to a specific day of the month (1-31).
      - name: month
        value: ''
        type: query
        description: Filter to a specific month (1-12).
      - name: location
        value: ''
        type: query
        description: ISO-3166 state or region code (e.g., us-ca for California).
      - name: type
        value: ''
        type: query
        description: Filter by holiday type (national, local, religious, observance).
      - name: language
        value: ''
        type: query
        description: Premium parameter. Two-letter ISO639 language code.
      - name: uuid
        value: ''
        type: query
        description: Premium parameter. Include UUID values for each holiday.
    docs: 'Returns holidays for a given country and year. Supports filtering

      by month, day, location (sub-region), holiday type, and language.

      '
- info:
    name: Countries
    type: folder
  items:
  - info:
      name: List Countries
      type: http
    http:
      method: GET
      url: https://calendarific.com/api/v2/countries
      params:
      - name: api_key
        value: ''
        type: query
        description: Calendarific API key.
    docs: 'Returns the full list of countries supported by Calendarific,

      including ISO-3166 codes and the languages supported per country.

      '
- info:
    name: Languages
    type: folder
  items:
  - info:
      name: List Languages
      type: http
    http:
      method: GET
      url: https://calendarific.com/api/v2/languages
      params:
      - name: api_key
        value: ''
        type: query
        description: Calendarific API key.
    docs: 'Returns the full list of languages supported by Calendarific

      with their two-letter ISO639 codes.

      '
bundled: true