A small calendar API

Holiday endpoint

GET /api/v1/holidays/US/2027 returns national US holidays, including observed dates. Use a two-letter country code or a supported country slug. Data covers 2020–2030. Regional holidays are excluded.

Calendar endpoint

GET /api/v1/calendar/2027/1?week_start=monday returns the month’s day count, offset, rows, day cells, and ISO week labels. Month can be a number or an English month name.

Requests & errors

Responses are JSON with no authentication required. The limit is 120 requests per network address per minute. An invalid date or country returns 400 or 404. A request over the limit returns 429 with Retry-After: 60.

Use with attribution

Use the data with a link to Grid & Calendar and the original holiday source. The holiday dataset is supplied by the MIT-licensed Nager.Date project; see Sources for provenance.

Try the calendar endpoint or view US holidays.

Last updated 2026-10-02