A country for that year of holidays. A country and a date for the holiday on that day, or null.

Official national calendars for nine countries. Listed below.

How do I check one date?

GET /holiday/{country}/{date} returns the holiday or null.

GET /holiday/{country} · /{country}/{date}

Holiday API

Pass a country. Get that year's holidays, or ask about one date.

You have a country and a day. The holiday, or null.

date

Date, YYYY-MM-DD

name

Official name, English or the official translation (France stays French)

type

public for an official day off, observance for cultural days (Halloween, Black Friday)

substitute

The day off moved (a holiday falling on a weekend, observed on a weekday)

regions

Region codes when only part of the country takes the day (GB: ENG, WLS, SCT, NIR), null when nationwide

holiday

The holiday on that date (same shape as holidays[]), or null

holidays

Every holiday and observance in that year

Pass a country

US, GB, FR, JP, and five more. Official calendars.

Read the year

Date, name, type, substitute when the day off moved.

Check one date

A date path returns the holiday or null.

9 countries.

Official sources. Every plan.

2,671
public holidays: 1,353
observances: 1955
JP calendar since

Pass a country code and get that year's holidays: date, name, type, and whether the day off moved (substitute). Each calendar is the official national source for that country. Years carry cultural observances like Halloween, Mother's Day, and White Day next to the official days, told apart by type. Add ?year= for another year, or ask about one date at /holiday/{country}/{date} and read holiday or null.

France, Austria, and Slovenia keep their native names. Japan, Hong Kong, and Taiwan pair the English name with the native form in local_name. GB rows carry a regions tag when only part of the UK takes the day.

RESPONSE

$ curl "https://api.parseapi.com/holiday/US" \
  -H "X-API-Key: YOUR_API_KEY"

// 200 · ~35ms US · ~97ms worldwide
{
  "country": "US",
  "year": 2026,
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "New Year's Day",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-01-19",
      "name": "Birthday of Martin Luther King, Jr.",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-02-14",
      "name": "Valentine's Day",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-02-16",
      "name": "Washington's Birthday",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-03-17",
      "name": "St. Patrick's Day",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-04-03",
      "name": "Good Friday",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-04-05",
      "name": "Easter Sunday",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-05-05",
      "name": "Cinco de Mayo",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-05-10",
      "name": "Mother's Day",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-05-25",
      "name": "Memorial Day",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-06-19",
      "name": "Juneteenth National Independence Day",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-06-21",
      "name": "Father's Day",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-07-03",
      "name": "Independence Day",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": true
    },
    {
      "date": "2026-09-07",
      "name": "Labor Day",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-10-12",
      "name": "Columbus Day",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-10-31",
      "name": "Halloween",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-11-11",
      "name": "Veterans Day",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-11-26",
      "name": "Thanksgiving Day",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-11-27",
      "name": "Black Friday",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-12-24",
      "name": "Christmas Eve",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-12-25",
      "name": "Christmas Day",
      "local_name": null,
      "type": "public",
      "regions": null,
      "substitute": false
    },
    {
      "date": "2026-12-31",
      "name": "New Year's Eve",
      "local_name": null,
      "type": "observance",
      "regions": null,
      "substitute": false
    }
  ]
}

Response fields

country: ISO2 country code
year: Year returned
holidays: Every holiday and observance in that year
holidays[].date: Date, YYYY-MM-DD
holidays[].name: Official name, English or the official translation (France stays French)
holidays[].local_name: Native form when it differs (Japan kanji, Hong Kong and Taiwan Chinese), null otherwise
holidays[].type: public for an official day off, observance for cultural days (Halloween, Black Friday)
holidays[].regions: Region codes when only part of the country takes the day (GB: ENG, WLS, SCT, NIR), null when nationwide
holidays[].substitute: The day off moved (a holiday falling on a weekend, observed on a weekday)

QUESTIONS

When do I use which?: A country for that year of holidays. A country and a date for the holiday on that day, or null.
Which calendars?: Official national calendars for nine countries. Listed below.
How do I check one date?: GET /holiday/{country}/{date} returns the holiday or null.

SPEED

How long /holiday takes.

11ms

12ms

APAC

44ms

LatAm

9ms

109ms

See live status →

Coverage

Nine countries, each from its official national source.

United States
United Kingdom
France
Japan
Singapore
Hong Kong
Taiwan
Slovenia
Austria

See this year's holidays by country in the public holidays tool, with the next one counted down.

Get started Docs