---
title: "GET /api/calendars/topics/holiday"
method: GET
path: "/api/calendars/topics/holiday"
tags: ["Calendars"]
---

# GET /api/calendars/topics/holiday

`GET /api/calendars/topics/holiday`

Returns topic metadata for an active holiday on a requested date. If no holiday exists for the given day, this endpoint will return a 404 error. All three parameters (`year`, `month`, `day`) are required to query a specific date. If no date is specified, the endpoint uses the current date.

## Query parameters

- `year` integer
- `month` integer
- `day` integer
- `lang` 'en' | 'he'

## Response `200`

Successful Response

- CalendarHolidayTopicJSON — Topic metadata for an active holiday. Returns 404 when no holiday is in season for the requested date.
  - `topic` object
  - `secondary_topic` object, nullable
  - `display_start_date` string, nullable
  - `display_end_date` string, nullable
  - `display_date_prefix` string, nullable
  - `display_date_suffix` string, nullable

---

[API](https://skmtc.net/sefaria/apis/sefaria-api.md) · [All operations](https://skmtc.net/sefaria/apis/sefaria-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sefaria/sefaria-api/revisions/d29296717011/schema)