> ## Documentation Index
> Fetch the complete documentation index at: https://docs.courtrules.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Court Holidays

> Returns court holidays and closure dates

Returns court holidays and closure dates with official source URLs. Use this
endpoint to power deadline calculators, court closure checks, and calendar
exports.

For a single court, you can also call
`GET /api/v1/courts/{district_id}/holidays` with the same `year`,
`date_from`, `date_to`, and `limit` query parameters.

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl 'https://api.courtrules.app/api/v1/holidays?district_id=edny&year=2026' \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import requests

  resp = requests.get(
      "https://api.courtrules.app/api/v1/holidays",
      params={"district_id": "edny", "year": 2026},
      headers={"Authorization": "Bearer YOUR_API_KEY"},
  )
  holidays = resp.json()
  ```

  ```typescript Node.js theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const params = new URLSearchParams({ district_id: "edny", year: "2026" });
  const resp = await fetch(`https://api.courtrules.app/api/v1/holidays?${params}`, {
    headers: { Authorization: "Bearer YOUR_API_KEY" },
  });
  const holidays = await resp.json();
  ```
</RequestExample>

<ResponseExample>
  ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "holidays": [
      {
        "district_id": "edny",
        "calendar_year": 2026,
        "holiday_date": "2026-01-01",
        "holiday_name": "New Year's Day",
        "source_url": "https://www.nyed.uscourts.gov/holiday-schedule",
        "last_checked_at": "2026-05-13T12:00:00.000Z"
      },
      {
        "district_id": "edny",
        "calendar_year": 2026,
        "holiday_date": "2026-01-19",
        "holiday_name": "Birthday of Martin Luther King, Jr.",
        "source_url": "https://www.nyed.uscourts.gov/holiday-schedule",
        "last_checked_at": "2026-05-13T12:00:00.000Z"
      }
    ],
    "meta": {
      "total": 2,
      "district_id": "edny",
      "year": 2026,
      "limit": 100
    }
  }
  ```
</ResponseExample>

## Query parameters

<ParamField query="district_id" type="string">
  Optional court identifier, such as `edny`.
</ParamField>

<ParamField query="year" type="integer">
  Optional calendar year filter, such as `2026`.
</ParamField>

<ParamField query="date_from" type="string">
  Optional lower date bound in `YYYY-MM-DD` format.
</ParamField>

<ParamField query="date_to" type="string">
  Optional upper date bound in `YYYY-MM-DD` format.
</ParamField>

<ParamField query="limit" type="integer">
  Maximum number of holidays to return. Defaults to `100`; maximum is `500`.
</ParamField>

## Response fields

<ResponseField name="holidays" type="array">
  Array of court holiday objects.

  <Expandable title="Holiday object">
    <ResponseField name="district_id" type="string">
      Court identifier for the holiday calendar.
    </ResponseField>

    <ResponseField name="calendar_year" type="integer">
      Calendar year for the holiday.
    </ResponseField>

    <ResponseField name="holiday_date" type="string">
      Closure date in `YYYY-MM-DD` format.
    </ResponseField>

    <ResponseField name="holiday_name" type="string">
      Holiday or closure name as published by the court.
    </ResponseField>

    <ResponseField name="source_url" type="string">
      Official source URL for the court holiday schedule.
    </ResponseField>

    <ResponseField name="last_checked_at" type="string">
      Timestamp when Court Rules last checked the source.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="meta" type="object">
  Response metadata, including the applied filters and number of holidays returned.
</ResponseField>