Skip to main content
GET
Preview holidays for a category

Authorizations

Authorization
string
header
required

Query Parameters

categoryKey
string
required

Country or region key from /holidays/categories (e.g. DE, DE-BY).

Maximum string length: 30
Example:

"DE"

year
integer

Restrict the preview to a single calendar year. Omit for a multi-year preview that surfaces each holiday's next occurrence.

Required range: 2000 <= x <= 2100
Example:

2026

Response

OK

collection
object[]
required

Holidays that fall in the requested category.

Last modified on April 29, 2026