Court Holidays

GET

api

holidays

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

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()

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();

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

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()

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();

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

string

Optional court identifier, such as edny.

integer

Optional calendar year filter, such as 2026.

string

Optional lower date bound in YYYY-MM-DD format.

string

Optional upper date bound in YYYY-MM-DD format.

integer

Maximum number of holidays to return. Defaults to 100; maximum is 500.

Response fields

array

Array of court holiday objects.

Show Holiday object

string

Court identifier for the holiday calendar.

integer

Calendar year for the holiday.

string

Closure date in YYYY-MM-DD format.

string

Holiday or closure name as published by the court.

string

Official source URL for the court holiday schedule.

string

Timestamp when Court Rules last checked the source.

object

Response metadata, including the applied filters and number of holidays returned.

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

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()

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();

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

Overview

Endpoints

Policies

Query parameters

Response fields

​Query parameters

​Response fields

Query parameters

Response fields