Public holidays for a country and year, optionally for one state or region

GET/v1/holidays

Public holidays for a country and year, optionally for one state or region

countryquery · stringREQUIRED

ISO 3166-1 alpha-2 code

e.g. US

yearquery · integer

Year (default: the current year)

e.g. 2026

subdivisionquery · string

State / province / region code

e.g. TX

curl "https://api.apialmanac.com/v1/holidays?country=US" \
  -H "X-API-Key: YOUR_KEY"

import requests

r = requests.get("https://api.apialmanac.com/v1/holidays?country=US", headers={"X-API-Key": "YOUR_KEY"})
print(r.status_code, r.headers.get("X-Gw-Remaining"))
print(r.json())

const r = await fetch("https://api.apialmanac.com/v1/holidays?country=US", {
  headers: { "X-API-Key": "YOUR_KEY" }
});
console.log(r.status, r.headers.get("X-Gw-Remaining"));
console.log(await r.json());

{
  "country": "US",
  "name": "United States",
  "year": 2026,
  "subdivision": null,
  "weekend": [
    "Saturday",
    "Sunday"
  ],
  "count": 2,
  "holidays": [
    {
      "date": "2026-01-01",
      "weekday": "Thursday",
      "name": "New Year's Day",
      "national": true,
      "subdivisions": null
    },
    {
      "date": "2026-01-19",
      "weekday": "Monday",
      "name": "Martin Luther King Jr. Day",
      "national": true,
      "subdivisions": null
    }
  ]
}