EventsMAINTAINED1 token / call

Public Holidays API

Public holidays for 204 countries and territories, served from our own database — 23,786 holidays covering 2020 through 2028, sourced from the MIT-licensed Nager.Date project. Each holiday carries its English and local name, nationwide-vs-regional scope (with ISO subdivision codes: Lincoln's Birthday lists US-CA, US-NY...), fixed-date flag and types (Public, Bank, Observance...). Get a country's year (US 2026 correctly shows Independence Day observed on Friday July 3), ask if a given date is a holiday (/holidays/today — 178 countries celebrate December 25), pull the next upcoming holidays for any country, or request computed long weekends (US 2026 has 8 three-day-plus breaks, listed with dates and the anchor holiday). The original /v1/{year}/{code} route still works unchanged, so existing integrations keep running — but responses now come from D1 in milliseconds with multi-year history instead of a third-party proxy call. Scheduling, HR and payroll tools, delivery-date calculators, booking systems and marketing calendars.

Start free — 500 tokens / mo →See all plans

No credit card requiredAccess to 20+ APIsCancel anytime

response.json

{
  "query": "GET /v1/holidays/today?country=US&date=2026-07-03",
  "is_public_holiday": true,
  "holiday": "Independence Day (observed)",
  "coverage": "204 countries, 2020-2028",
  "long_weekends": "computed per country/year"
}

Also available on

RapidApi

6endpoints

1tokens / call

99.9%uptime SLA

Lowavg latency

Why developers pick this API

Production-ready

Production Ready

Battle-tested infrastructure with a 99.9% uptime SLA. Rate limits are generous, responses are consistent.

Simple Integration

Standard REST + JSON. Works with any HTTP client. Copy-ready code snippets in 4 languages.

One Key, 20+ APIs

Your DataAndAPIs subscription unlocks every API on the platform — anime, finance, sports, and more.

Code snippets

One install. Every endpoint.

No proprietary SDKs needed. Any HTTP client works. Pick your language and paste.

3languages

6endpoints

RESTarchitecture

1key for all APIs

Fully typed responses — auto-completion in your IDE
Tracks the API in lockstep — new endpoints land same day
One key works across 20+ APIs on the platform

import axios from 'axios';

const { data } = await axios.get(
  '{API_URL}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

🔒 Subscribe to unlock the live API URL

Developer playground

Explore the endpoints

Browse request parameters and inspect live example responses.

Available Endpoints

Request Parameters

API URL

Please subscribe to see the API URL

Headers

X-Api-Key

Path Parameters

country

year

Please subscribe to see the actual API URL

Target:

Client:

import axios from 'axios';

const url = '{API_URL}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

Pricing

One subscription. Every API.

Tokens unlock this API and 20+ others on DataAndAPIs. Switch APIs any time — we promote.

FREE

$0/mo

500 tokens / month

Access to all APIs
Tokens reset monthly
Community support

Start free

The things that actually block the upgrade.

Ship Public Holidays API this afternoon.

500 free tokens. No card. Plus 20+ other APIs on the same key.

Get API key →Browse all APIs