{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/api-ninjas-com/json-schema/api-ninjas-com-bank-holiday-schema.json",
  "title": "BankHoliday",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/api-ninjas-com-bank-holidays-api-openapi.yml#/components/schemas/BankHoliday",
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "description": "Name of the bank holiday."
    },
    "date": {
      "type": "string",
      "format": "date",
      "description": "Date of the bank holiday in YYYY-MM-DD format."
    },
    "country": {
      "type": "string",
      "description": "2-letter ISO 3166-1 alpha-2 country code."
    },
    "year": {
      "type": "integer",
      "description": "Calendar year of `date`."
    },
    "regions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "ISO 3166-2 codes of the states, provinces or regions where the holiday applies (e.g. `GB-SCT`)."
    },
    "actual_date": {
      "type": "string",
      "format": "date",
      "description": "Calendar date of the holiday itself. Differs from `date` only on observed days."
    },
    "observed": {
      "type": "boolean",
      "description": "True when `date` is an observed or substitute day off for a holiday that falls on another day."
    },
    "holiday_id": {
      "type": "string",
      "description": "Stable identifier of the holiday, the same every year (e.g. `US.independence_day`). An observed day shares the id of its holiday."
    },
    "status": {
      "type": "string",
      "enum": [
        "confirmed",
        "tentative"
      ],
      "description": "`tentative` for dates that depend on a lunar sighting or have not yet been officially announced; they may move by a day."
    }
  }
}