API Almanac
API reference › Holidays

Countries with holiday data, and their subdivisions

GET/v1/holidays/countries

GET/v1/holidays/countries

Countries with holiday data, and their subdivisions

In the full reference
REQUEST
curl "https://api.apialmanac.com/v1/holidays/countries" \
  -H "X-API-Key: YOUR_KEY"
RESPONSE
200OK
{
  "count": 2,
  "countries": [
    {
      "country": "US",
      "name": "United States",
      "subdivisions": 57,
      "years": "2020–2030"
    },
    {
      "country": "GB",
      "name": "United Kingdom",
      "subdivisions": 4,
      "years": "2020–2030"
    }
  ]
}
Try it — sign in first
Runs on a sandbox key: 200 requests a month. Your real key is for production.