Public Holidays API

Public and bank holidays for 100+ countries and their states/regions, any year, localized names, plus 'is this date a holiday?' check. Data: date-holidays (CC BY 3.0).

Authentication & base URL

Subscribe through one of our marketplace listings; your marketplace API key and base URL are shown there. All endpoints return JSON over HTTPS, served from a global edge network (typically 20–150 ms).

Subscribe on RapidAPI

Endpoints

GET `/v1/holidays`

Holidays of a year

Parameter	In	Description	Example
`country` *	query	ISO country code	`ES`
`year`	query	Year	`2026`
`state`	query	State/region code	`MD`
`types`	query	public, bank, optional, school, observance or all	`public`
`lang`	query	Language of names	`en`

GET `/v1/holidays/is-holiday`

Is it a holiday?

Parameter	In	Description	Example
`country` *	query	ISO country code	`US`
`date`	query	YYYY-MM-DD	`2026-12-25`
`state`	query	State/region

GET `/v1/holidays/regions`

Countries and regions

Parameter	In	Description	Example
`country`	query	ISO country code (empty = list countries)	`DE`

Example

GET /v1/holidays?country=ES&year=2026&state=MD&types=public&lang=en

{
  "country": "ES",
  "state": "MD",
  "year": 2026,
  "count": 14,
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "New Year's Day",
      "type": "public",
      "substitute": false
    },
    {
      "date": "2026-01-06",
      "name": "Epiphany",
      "type": "public",
      "substitute": false
    },
    {
      "date": "2026-04-02",
      "name": "Maundy Thursday",
      "type": "public",
      "substitute": false
    },
    {
      "date": "2026-04-03",
      "name": "Good Friday",
      "type": "public",
      "substitute": false
    },
    {
      "date": "2026-05-01",
      "name": "Labour Day",
      "type": "public",
      "substitute": false
    },
    {
      "date": "2026-05-02",
      "name": "Día de la Comunidad de Madrid",
      "type": "public",
      "substitute": false
    },
    {
      "date": "2026-08-15",
      "name": "Assumption",
      "type": "public",
      "substitute": false
    },
    {
      "date": "2026-10-12",
      "name": "Fiesta Nacional de España",
      "type": "public",
      "substitute": false
    },
    {
      "date": "2026-11-01",
      "name": "All Saints' Day",
      "type": "public",
      "substitute": false
    },
    {
      "date": "2026-11-02",
      "name": "All Saints' Day (substitute day)",
      "type": "public",
      "substitute": true
    },
    {
      "date": "2026-12-06",
      "name": "Día de la Constitución Española",
      "type": "public",
  …

Public and bank holidays for 100+ countries and their states/regions, any year, localized names, plus 'is this date a holiday?' check. Data: date-holidays (CC BY 3.0).

Use cases

Scheduling and delivery date calculations, HR and payroll, booking systems, business-day logic.

Why this API

Fast: runs on a global edge network, typical response well under 1 second.
Reliable: simple JSON, clear error messages.
Fair pricing: Free plan 500 requests/month, Pro 25,000 for $4.99.

Pricing

Free plan with 500 calls per month, then Pro (25,000 calls for $4.99/month) and Ultra (150,000 calls for $14.99/month). See all plans.