Public Holiday Calendar (by Country and Year)

{
  "type": "object",
  "required": [
    "country_code"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Year (default current year)"
    },
    "country_code": {
      "type": "string",
      "description": "ISO 2-letter country code"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Error code returned when the request cannot be fulfilled, e.g. an unrecognized country_code (observed: 'HTTP_400'). Present only on a rejected request, alongside `message`, in place of the holiday fields above."
    },
    "year": {
      "type": "number",
      "description": "The year requested, echoed back."
    },
    "message": {
      "type": "string",
      "description": "Human-readable explanation of the error, present only alongside `code`."
    },
    "holidays": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "ISO 8601 date (YYYY-MM-DD)."
          },
          "name": {
            "type": "string",
            "description": "The holiday's public name, not a person's."
          },
          "type": {
            "type": "string",
            "description": "Observed values on the one fixture captured: 'Public', 'Bank', 'Optional', 'School', 'Observance'. Other countries may report additional values not seen here."
          },
          "fixed": {
            "type": "boolean",
            "description": "Whether the date is fixed on the calendar. Observed `false` on every one of the 17 entries captured -- `true` was never observed; treat as a genuine boolean, not a guaranteed-false sentinel."
          },
          "global": {
            "type": "boolean",
            "description": "Whether the holiday is observed nationwide (`true`) or only in specific states/counties (`false`, in which case `counties` lists them)."
          },
          "counties": {
            "type": [
              "array",
              "null"
            ],
            "items": {
              "type": "string"
            },
            "description": "State/county subdivision codes where a `global: false` holiday applies; observed `null` whenever `global` is `true`."
          },
          "local_name": {
            "type": "string",
            "description": "The holiday's name; observed identical to `name` on some entries and different on others in the one fixture captured (e.g. 'Presidents Day' vs. 'Washington's Birthday') -- not a person's identity, a naming variant of the holiday itself."
          }
        },
        "additionalProperties": true
      },
      "description": "17 entries observed on the one fixture captured (US, 2026). A country/year with no holidays would presumably return an empty array, though that case was not observed."
    },
    "country_code": {
      "type": "string",
      "description": "The country code requested, echoed back."
    },
    "total_holidays": {
      "type": "number",
      "description": "Total number of entries in the holidays array."
    }
  },
  "description": "The holiday-calendar result, as returned at routing.responseResultPath ($.output). On a rejected request (e.g. an unrecognized country_code) the holiday fields are absent and only `code`/`message` are present -- see verification.notes.",
  "additionalProperties": true
}