Calendarific

Overview

Calendarific provides public holidays for 230+ countries and 3,000+ regions via a key-based API — dates, names, local names, types, and weekday info. A popular choice for multi-country holiday features (an invalid key returns 401 — verified).

Quick Start

Holidays for a country and year (replace YOUR_KEY):

curl "https://calendarific.com/api/v2/holidays?api_key=YOUR_KEY&country=US&year=2026"

{
  "response": {
    "holidays": [
      {
        "name": "New Year's Day",
        "date": { "iso": "2026-01-01" },
        "type": ["National holiday"],
        "country": { "id": "US", "name": "United States" },
        "locations": "All",
        "states": "All"
      }
    ]
  }
}

Specific month:

curl "https://calendarific.com/api/v2/holidays?api_key=YOUR_KEY&country=CN&year=2026&month=10"

Authentication

• Register at calendarific.com for a free API key (emailed).
• Send it as the api_key query parameter (an invalid key returns 401 — verified).

Rate Limits & Notes

• Free tier: 1,000 requests/month (with up to 100 holidays per response); paid plans scale.
• Covers 230+ countries; locations/states fields indicate regional scope.
• Holiday types include National, Observance, Season, Religious, and more.
• Responses include weekday info (date/name) and date.datetime fields.

FAQ

Is Calendarific free? Free tier: 1,000 requests/month; more is paid.

How do I get a key? Register at calendarific.com — the key is emailed.

How many countries? 230+ countries and 3,000+ regions.