HolidayDB

Holiday API

Global public holiday and vacation data for HR, payroll and compliance systems.

Accurate, up-to-date national and regional holiday and vacation data delivered via a simple API. Stop hardcoding calendars. Stop maintaining holiday and vacation logic manually.

Example request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.holidaydb.com/api/holidays?country=US"
Sample response
[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "country_code": "US",
    "religion_slug": null,
    "type": "public_holiday",
    "scope": "national",
    "region_codes": [],
    "region_names": [],
    "start_date": "2026-07-04",
    "end_date": "2026-07-04",
    "provisional": false,
    "substitute": false,
    "summary": "Independence Day",
    "language": "en"
  }
  // …more holiday objects in the full response (one entry per matching holiday)
]
See more examples
Free Dev Mode (no CC required)

Built for serious systems

HolidayDB is designed for:

  • HR management platforms

    Keep employee records and leave rules in sync with official holidays and vacation dates.

  • Payroll software

    Calculate holiday and vacation pay and overtime correctly with accurate dates.

  • Leave management systems

    Validate leave requests against public holidays, vacation dates and regional rules.

  • Time tracking tools

    Mark holidays and vacation days automatically so timesheets stay compliant.

  • ERP systems

    Drive workflows and approvals from a single source of holiday truth.

  • SaaS products expanding internationally

    Add new countries without maintaining holiday and vacation logic per market.

Where holidays and vacation drive pay, leave balances or compliance, accuracy is non-negotiable.

What you get

  • National public holidays

    Regional calendars covering 231 countries. National-scope dates for each.

  • Subdivision-level holidays

    States, provinces, and regions: 4,788 ISO 3166-2 subdivisions in CountriesDB for 195 of 231 holiday countries.

  • Religious calendars

    Christian, Islamic, Jewish, Hindu, Orthodox Christianity. Stable religion_slug for filtering.

  • Multiple language support

    Holiday names in the language you need (Full plan).

  • Updated daily

    Including dates that may still change, so you stay accurate.

  • Clean REST API

    Simple endpoints, JSON responses, filters by country, religion, and date.

  • Reliable data structure

    Consistent fields and types for easy integration.

  • Development mode

    Test integration before going live, at no extra cost.

Why not use a static holiday or vacation list?

Hardcoded or copied holiday and vacation data creates hidden risk:

  • Holiday and vacation dates change and are updated daily
  • Subdivision-level holidays differ by region
  • Observed dates shift; some dates may still change
  • Maintenance becomes manual and error-prone
  • Payroll mistakes are expensive

HolidayDB removes that risk.

Example API requests

Returns all public holidays for a country. Response includes uuid, dates, type, scope, summary, region_names, and language.

Parameters
  • countryQuery: two-letter country code (ISO 3166-1 alpha-2), e.g. US, DE.
  • AuthorizationHeader: Bearer YOUR_API_KEY (required for all requests).
GET /api/holidays?country=US
Authorization: Bearer YOUR_API_KEY

[
  {
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "country_code": "US",
    "religion_slug": null,
    "type": "public_holiday",
    "scope": "national",
    "region_codes": [],
    "region_names": [],
    "start_date": "2026-07-04",
    "end_date": "2026-07-04",
    "provisional": false,
    "substitute": false,
    "summary": "Independence Day",
    "language": "en"
  }
]

Development Mode

Start integrating immediately. Development mode allows you to:

  • Test API integration
  • Access limited countries or sandbox data
  • Validate holiday logic in your system
  • Upgrade to production when you're ready to go live.
Free Dev Mode (no CC required)

Production Plans

All plans include: API access, secure authentication, versioned endpoints, documentation, email support.

Basic

API keys
1
Included Requests
10,000 / Month
Countries
All
National holidays
Yes
Subdivision holidays
No
Languages
English only
$29 / month

Pro

API keys
Up to 3
Included Requests
50,000 / Month
Countries
All
National holidays
Yes
Subdivision holidays
Yes
Languages
English only
Most Popular
$39 / month

Full

API keys
Up to 10
Included Requests
200,000 / Month
Countries
All
National holidays
Yes
Subdivision holidays
Yes
Languages
73 languages
$49 / month
10% off when you include attribution to our site
Get up to 25% off with affiliate referrals! See more!

Designed for international growth

Expanding into new countries? HolidayDB helps you:

  • Add new markets faster
  • Avoid compliance errors
  • Reduce engineering overhead
  • Keep holiday and vacation logic consistent across regions

Frequently Asked Questions

How often is the data updated?
Data is checked and updated daily, including dates that may still change, so you always have the latest holiday and vacation info.
Do you support subdivision-level holidays?
Yes. Subdivision-level holidays are available for: Austria, Australia, Bosnia and Herzegovina, Canada, Switzerland, Germany, Spain, Malaysia, United Kingdom, and the United States.
Can I use HolidayDB for payroll systems?
Yes. HolidayDB is built specifically for HR and payroll integrations.
Is there a free trial?
You can start in Development Mode to test integration before enabling production access.

Have more questions?

Stop maintaining holiday and vacation calendars manually.

Integrate once. Stay accurate every day.

Free Dev Mode (no CC required)