Public holidays by country API

Public holidays for a country and year. Free via Nager.Date. Answers 'public holidays in the US 2026', 'is this a holiday', 'list UK bank holidays'.

Price$0.01per request

MethodPOST

Route/v1/data/holidays

StatusLive

MIME typeapplication/json

Rate limit60/minute

Cache86400s public

dataholidayscalendarbusiness-dayscountry

API URLhttps://x402.hexl.dev/v1/data/holidays

Integration docs

Example request

{
  "country": "US",
  "year": 2026
}

Example response

{
  "country": "US",
  "year": 2026,
  "count": 11,
  "holidays": [
    {
      "date": "2026-01-01",
      "name": "New Year's Day",
      "localName": "New Year's Day",
      "global": true
    }
  ]
}

Input schema

{
  "type": "object",
  "required": [
    "country",
    "year"
  ],
  "properties": {
    "country": {
      "type": "string",
      "examples": [
        "US",
        "GB"
      ]
    },
    "year": {
      "type": "number",
      "examples": [
        2026
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "required": [
    "country",
    "year",
    "count",
    "holidays"
  ],
  "properties": {
    "country": {
      "type": "string"
    },
    "year": {
      "type": "number"
    },
    "count": {
      "type": "number"
    },
    "holidays": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      }
    }
  }
}