US federal holidays for a year API

Computes all 11 US federal holidays for a year from first principles (fixed dates, nth-weekday rules and the Saturday→Friday / Sunday→Monday observed rule) — no lookup table. Answers 'What are the US federal holidays in 2026?', 'When is Thanksgiving / observed July 4th?'.

Price$0.06per request

MethodPOST

Route/v1/datetime/us-federal-holidays

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

datetimeholidaysus-federalcalendarobservedthanksgivingmemorial-daycomputed

API URLhttps://x402.hexl.dev/v1/datetime/us-federal-holidays

Integration docs

Example request

{
  "year": 2026
}

Example response

{
  "year": 2026,
  "count": 11,
  "holidays": [
    {
      "name": "New Year's Day",
      "date": "2026-01-01",
      "weekday": "Thursday",
      "observed": "2026-01-01",
      "observedDiffers": false
    },
    {
      "name": "Birthday of Martin Luther King, Jr.",
      "date": "2026-01-19",
      "weekday": "Monday",
      "observed": "2026-01-19",
      "observedDiffers": false
    },
    {
      "name": "Washington's Birthday",
      "date": "2026-02-16",
      "weekday": "Monday",
      "observed": "2026-02-16",
      "observedDiffers": false
    },
    {
      "name": "Memorial Day",
      "date": "2026-05-25",
      "weekday": "Monday",
      "observed": "2026-05-25",
      "observedDiffers": false
    },
    {
      "name": "Juneteenth National Independence Day",
      "date": "2026-06-19",
      "weekday": "Friday",
      "observed": "2026-06-19",
      "observedDiffers": false
    },
    {
      "name": "Independence Day",
      "date": "2026-07-04",
      "weekday": "Saturday",
      "observed": "2026-07-03",
      "observedDiffers": true
    },
    {
      "name": "Labor Day",
      "date": "2026-09-07",
      "weekday": "Monday",
      "observed": "2026-09-07",
      "observedDiffers": false
    },
    {
      "name": "Columbus Day",
      "date": "2026-10-12",
      "weekday": "Monday",
      "observed": "2026-10-12",
      "observedDiffers": false
    },
    {
      "name": "Veterans Day",
      "date": "2026-11-11",
      "weekday": "Wednesday",
      "observed": "2026-11-11",
      "observedDiffers": false
    },
    {
      "name": "Thanksgiving Day",
      "date": "2026-11-26",
      "weekday": "Thursday",
      "observed": "2026-11-26",
      "observedDiffers": false
    },
    {
      "name": "Christmas Day",
      "date": "2026-12-25",
      "weekday": "Friday",
      "observed": "2026-12-25",
      "observedDiffers": false
    }
  ],
  "interpretation": "11 US federal holidays in 2026; MLK Day = 2026-01-19, Thanksgiving = 2026-11-26."
}

Input schema

{
  "type": "object",
  "required": [
    "year"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "examples": [
        2026
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}