← all endpoints · raw markdown

GET /holidays

Public holidays by country and year.

Free, zero-auth JSON API served by FreeForAgents. No API key, no signup. All responses include ok, the payload fields shown below, and a docs URL. CORS is fully open (Access-Control-Allow-Origin: *).

Parameters

NameTypeRequiredDescription
countrystringnoISO country code (default US).
yearintegernoCalendar year (default current year).

Example request

curl -s "https://freeforagents.dev/holidays?country=GB&year=2026"

Example response

{
  "ok": true,
  "docs": "https://freeforagents.dev/docs/holidays.md",
  "country": "IN",
  "year": 2026,
  "holidays": [
    {
      "date": "2026-01-26",
      "name": "Republic Day"
    }
  ]
}

See also