Holiday

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/api-ninjas-com/json-schema/api-ninjas-com-holiday-schema.json",
  "title": "Holiday",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/api-ninjas-com-openapi.json#/components/schemas/Holiday",
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "The name of the country or territory."
    },
    "iso": {
      "type": "string",
      "description": "2-letter ISO 3166-1 alpha-2 code of the country or territory, in upper case."
    },
    "year": {
      "type": "integer",
      "description": "The calendar year of the holiday."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "The date of the holiday in YYYY-MM-DD format."
    },
    "day": {
      "type": "string",
      "description": "The day of the week on which the holiday falls."
    },
    "name": {
      "type": "string",
      "description": "The name of the holiday."
    },
    "type": {
      "type": "string",
      "description": "The type of holiday, in upper case. Possible values:\n- `PUBLIC_HOLIDAY`: A national day off for the general population. Includes national holidays with a religious origin, such as Good Friday and Christmas Day in Germany.\n- `STATE_HOLIDAY`: A holiday observed at the state or regional level within a country, applicable to residents of that state but not necessarily the nation as a whole.\n- `LOCAL_HOLIDAY`: A holiday observed only within a specific city, district, or municipality, with no broader regional or national application.\n- `PROVINCE_TERRITORY_HOLIDAY`: A holiday specific to a province or territory within a federal state, such as those observed in Canadian provinces or Australian territories.\n- `DE_FACTO_HOLIDAY`: A day that is widely treated as a holiday in practice (through informal tradition, employer convention, or cultural norm) without a formal legal mandate.\n- `SUBSTITUTE_HOLIDAY`: A replacement day off granted when an official holiday falls on a weekend or non-working day, or when a holiday is moved to another date.\n- `BANK_HOLIDAY`: A day on which banks and financial institutions are officially closed. May or may not align with a general public holiday.\n- `GOVERNMENT_HOLIDAY`: A day off that applies specifically to government employees and public sector workers, which may not extend to the private sector or general population.\n- `PRIVATE_SECTOR_HOLIDAY`: A day off that applies specifically to private sector employees, which may differ from public sector or general population holidays.\n- `OPTIONAL_HOLIDAY`: A holiday that individuals or employers may choose to observe, but which carries no universal legal obligation.\n- `RESTRICTED_TRADING_DAY`: A day on which commercial or retail activity is permitted but subject to legal restrictions, such as limited trading hours. Not a full day off.\n- `CHRISTIAN_HOLIDAY`: A Western Christian (Catholic or Protestant) religious observance that is not a national day off.\n- `ORTHODOX_HOLIDAY`: An Eastern Orthodox Christian religious observance that is not a national day off.\n- `MUSLIM_HOLIDAY`: An Islamic religious observance that is not a national day off.\n- `JEWISH_HOLIDAY`: A Jewish religious observance that is not a national day off.\n- `HINDU_HOLIDAY`: A Hindu religious observance that is not a national day off.\n- `OBSERVANCE`: A recognized day of cultural, civic, or commemorative significance that is not an official day off. A holiday that is suspended or cancelled in a given year is also typed `OBSERVANCE` for that year.\n- `UNITED_NATIONS_OBSERVANCE`: An observance designated by the United Nations or another international body, recognised globally rather than within a single country or region.\n- `FLAG_DAY`: A day designated to honour a nation's flag, often marked by ceremonies or displays.\n- `SILENT_DAY`: A day on which noise, public gatherings, or commercial activity is restricted by law or strong cultural convention, typically for remembrance or mourning.\n- `HALF_DAY`: A partial holiday on which businesses or institutions close for only part of the day, typically the afternoon.\n- `WORKING_DAY`: A regular working day that may coincide with a notable calendar event but is not a day off.\n- `SEASON`: An astronomical event marking the start of a new season: an equinox or solstice.\n- `CLOCK_CHANGE`: A day on which clocks are adjusted for daylight saving time. Not a day off, but a notable calendar event affecting daily schedules.\n- `COVID_19_MEASURE`: A non-working day or closure introduced in response to the COVID-19 pandemic, such as a lockdown, work suspension, or emergency public holiday.\n- `SPORTING_EVENT`: A day designated around a major sporting event, which may result in altered working hours, public gatherings, or unofficial closures.",
      "enum": [
        "PUBLIC_HOLIDAY",
        "STATE_HOLIDAY",
        "LOCAL_HOLIDAY",
        "PROVINCE_TERRITORY_HOLIDAY",
        "DE_FACTO_HOLIDAY",
        "SUBSTITUTE_HOLIDAY",
        "BANK_HOLIDAY",
        "GOVERNMENT_HOLIDAY",
        "PRIVATE_SECTOR_HOLIDAY",
        "OPTIONAL_HOLIDAY",
        "RESTRICTED_TRADING_DAY",
        "CHRISTIAN_HOLIDAY",
        "ORTHODOX_HOLIDAY",
        "MUSLIM_HOLIDAY",
        "JEWISH_HOLIDAY",
        "HINDU_HOLIDAY",
        "OBSERVANCE",
        "UNITED_NATIONS_OBSERVANCE",
        "FLAG_DAY",
        "SILENT_DAY",
        "HALF_DAY",
        "WORKING_DAY",
        "SEASON",
        "CLOCK_CHANGE",
        "COVID_19_MEASURE",
        "SPORTING_EVENT"
      ]
    }
  }
}