Public Holidays API

Pricing

Documentation

curl "https://public-holidays.p.apihiver.com/v1/holidays?country=IN&subdivision=MH" \
  -H "X-API-Key: YOUR_API_KEY"

{"error": {"code": "INVALID_INPUT", "message": "country: Field required"}}

Public Holidays API FAQ

Is the Public Holidays API free?

Yes. The Basic plan is free and includes 500 requests per month — no card needed. Paid plans start at ₹299 per month for 10,000 requests.

How much does the Public Holidays API cost?

Basic: free for 500 requests; Pro: ₹299/month for 10,000 requests; Ultra: ₹999/month for 50,000 requests; Mega: ₹2,499/month for 2,00,000 requests. Billing is monthly and you can cancel any time.

How do I use the Public Holidays API?

Subscribe to a plan on APIHiver, create an API key in the Console, then send requests to https://public-holidays.p.apihiver.com with your key in the X-API-Key header. You can also try every endpoint in the browser playground first.

What endpoints does the Public Holidays API have?

It has 5 endpoints: All public holidays for a country and year (GET /v1/holidays); Is a date a public holiday (and is it a weekend)? (GET /v1/is-holiday); Upcoming public holidays from a date (GET /v1/next); Count working days between two dates (skips weekends and holidays) (GET /v1/working-days); Supported countries and their state/region codes (GET /v1/countries).

What are the Public Holidays API rate limits?

Basic: 2 requests per second; Pro: 5 requests per second; Ultra: 10 requests per second; Mega: 20 requests per second. Monthly quotas depend on the plan; every response includes X-RateLimit headers showing what's left.

Can I use one API key for the Public Holidays API and other APIs?

Yes. One APIHiver key works for every API you subscribe to, so you don't need a separate account or key per provider.

Related APIs