Calendarific

aid: calendarific
name: Calendarific
description: >-
  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.
url: https://calendarific.com/
specificationVersion: '0.20'
created: '2026-05-28'
modified: '2026-05-29'
x-source: public-apis/public-apis
x-category: Calendar
x-tier: 3
x-tier-reason: bulk-registered-from-public-apis
tags:
  - Calendar
  - Public APIs
  - Holidays
  - Worldwide
  - Localization
apis:
  - name: Calendarific Holiday API
    description: >-
      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 language.
    humanURL: https://calendarific.com/api-documentation
    baseURL: https://calendarific.com/api/v2
    tags:
      - Calendar
      - Holidays
      - Worldwide
    properties:
      - type: Documentation
        url: https://calendarific.com/api-documentation
      - type: APIReference
        url: https://calendarific.com/api-documentation
      - type: OpenAPI
        url: openapi/calendarific-openapi.yml
      - type: JSONSchema
        url: json-schema/calendarific-holiday-schema.json
      - type: JSONSchema
        url: json-schema/calendarific-country-schema.json
      - type: JSONSchema
        url: json-schema/calendarific-language-schema.json
      - type: JSONStructure
        url: json-structure/calendarific-holiday-structure.json
      - type: JSONStructure
        url: json-structure/calendarific-country-structure.json
      - type: JSONStructure
        url: json-structure/calendarific-language-structure.json
      - type: JSONLD
        url: json-ld/calendarific-context.jsonld
      - type: Example
        url: examples/calendarific-list-holidays-example.json
      - type: Example
        url: examples/calendarific-list-countries-example.json
      - type: Example
        url: examples/calendarific-list-languages-example.json
      - type: Authentication
        url: https://calendarific.com/api-documentation
      - type: RateLimits
        url: rate-limits/calendarific-rate-limits.yml
common:
  - type: Website
    url: https://calendarific.com/
  - type: DeveloperPortal
    url: https://calendarific.com/api-documentation
  - type: SignUp
    url: https://calendarific.com/signup
  - type: Login
    url: https://calendarific.com/login
  - type: Pricing
    url: https://calendarific.com/pricing
  - type: Plans
    url: plans/calendarific-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/calendarific-rate-limits.yml
  - type: TermsOfService
    url: https://calendarific.com/terms
  - type: PrivacyPolicy
    url: https://calendarific.com/privacy
  - type: Support
    url: https://calendarific.com/contact
  - type: Contact
    url: https://calendarific.com/contact
  - type: GitHubOrganization
    url: https://github.com/calendarific
  - type: SDK
    name: Python SDK
    url: https://github.com/calendarific/python-calendarific
  - type: SDK
    name: Node.js SDK
    url: https://github.com/calendarific/node-calendarific
  - type: SDK
    name: PHP SDK
    url: https://github.com/calendarific/php-calendarific
  - type: SDK
    name: Ruby SDK
    url: https://github.com/calendarific/ruby-calendarific
  - type: SDK
    name: Go SDK
    url: https://github.com/calendarific/go-calendarific
  - type: SDK
    name: .NET SDK (community)
    url: https://github.com/guibranco/calendarific-sdk-dotnet
  - type: SDK
    name: PowerShell wrapper (community)
    url: https://github.com/rchaganti/PSCalendarific
  - type: SDK
    name: Elixir wrapper (community)
    url: https://github.com/Bounceapp/elixir-calendarific
  - type: SpectralRules
    url: rules/calendarific-rules.yml
  - type: Vocabulary
    url: vocabulary/calendarific-vocabulary.yml
  - type: NaftikoCapability
    url: capabilities/shared/calendarific-holidays.yaml
  - type: NaftikoCapability
    url: capabilities/holiday-calendar-sync.yaml
  - type: NaftikoCapability
    url: capabilities/global-coverage-catalog.yaml
  - type: Tools
    name: Calendarific MCP Server (community)
    url: https://github.com/noalimoy/calendarific-mcp-server
  - type: Features
    data:
      - name: 230+ Countries
        description: Coverage of national holidays across more than 230 countries.
      - name: Multi-Language Localization
        description: Holiday names and descriptions in many ISO-639 languages (premium).
      - name: Holiday Type Filtering
        description: Filter by national, local, religious, or observance categories.
      - name: Sub-Region Filtering
        description: Filter by ISO-3166-2 state or region codes.
      - name: Historical and Future Data
        description: Holidays from historical years through 2049.
      - name: CSV and XLS Export
        description: Download holiday data as flat files in addition to API access.
      - name: Multiple API Keys
        description: Multiple keys per account for environment separation.
  - type: UseCases
    data:
      - name: Ecommerce Scheduling
        description: Plan promotions, shipping cutoffs, and customer service hours around local holidays.
      - name: HR and Payroll
        description: Populate localized leave calendars and statutory holiday pay.
      - name: Travel Planning
        description: Surface holiday windows that affect bookings, demand, and pricing.
      - name: Workforce Scheduling
        description: Plan global team staffing around local public holidays.
      - name: Calendar Sync
        description: Hydrate enterprise calendars (Google, Outlook) with localized holidays.
      - name: Financial Markets
        description: Identify country-specific trading and settlement closures.
  - type: Integrations
    data:
      - name: Google Calendar
        description: Imported holiday data into Google Calendar via custom calendars.
      - name: Microsoft Outlook
        description: Hydrate Outlook calendars with localized holiday events.
      - name: Home Assistant
        description: Community Home Assistant sensor uses Calendarific as a data source.
      - name: ETL Pipelines
        description: Community ETL examples using Python, SQLite, and Apache Airflow.
  - type: Solutions
    data:
      - name: Developer API
        description: REST API for embedding holiday data into apps and services.
      - name: Data Downloads
        description: CSV and XLS bulk exports for analytics and offline use.
maintainers:
  - FN: Kin Lane
    email: [email protected]