Skip to main content
GET
/
api
/
v1
/
holidays
curl 'https://api.courtrules.app/api/v1/holidays?district_id=edny&year=2026' \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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
  }
}
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. 
curl 'https://api.courtrules.app/api/v1/holidays?district_id=edny&year=2026' \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "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
  }
}

​
Query parameters

​
district_id
string
Optional court identifier, such as edny.
​
year
integer
Optional calendar year filter, such as 2026.
​
date_from
string
Optional lower date bound in YYYY-MM-DD format.
​
date_to
string
Optional upper date bound in YYYY-MM-DD format.
​
limit
integer
Maximum number of holidays to return. Defaults to 100; maximum is 500.

​
Response fields

​
holidays
array
Array of court holiday objects.
​
meta
object
Response metadata, including the applied filters and number of holidays returned.