{
  "x402Version": 2,
  "id": 32278,
  "slug": "32278",
  "resource": "https://workbot1.oddsys.org/holidays",
  "description": "Public holidays for ~200 countries and their subdivisions, plus business-day arithmetic: is this date a holiday or business day, next business day, add N business days, count business days between dates. Configurable weekend and holiday types.",
  "type": "http",
  "serviceName": "Busker Holidays & Business Days",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x15459498e1191d8787c83177809bd54022fA18c4",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "2000",
      "amountUsd": 0.002,
      "maxTimeoutSeconds": 300
    }
  ],
  "outputSchema": {
    "body": {
      "businessDays": "number (range mode); calendarDays; holidays[]",
      "calendar": "object — { country, countryName, state?, types, weekend, source }",
      "holidays": "array (year mode) — { date, name, type, substitute? }",
      "isBusinessDay": "boolean (date mode); isHoliday; holidays[]; nextBusinessDay",
      "result": "string (days mode) — resulting date; weekday; skipped { weekendDays, holidays }"
    },
    "bodyType": "json",
    "example": {
      "calendar": {
        "country": "US",
        "countryName": "United States of America",
        "source": "date-holidays ruleset (data CC-BY-3.0, attribution required if redistributed)",
        "types": [
          "public"
        ],
        "weekend": [
          "Sunday",
          "Saturday"
        ]
      },
      "days": 3,
      "from": "2026-12-24",
      "result": "2026-12-30",
      "skipped": {
        "holidays": [
          {
            "date": "2026-12-25",
            "name": "Christmas Day"
          }
        ],
        "weekendDays": 2
      },
      "weekday": "Wednesday"
    }
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "body": {
            "country": "US",
            "days": 3,
            "from": "2026-12-24"
          },
          "bodyType": "json",
          "method": "POST",
          "type": "http"
        },
        "output": {
          "body": {
            "businessDays": "number (range mode); calendarDays; holidays[]",
            "calendar": "object — { country, countryName, state?, types, weekend, source }",
            "holidays": "array (year mode) — { date, name, type, substitute? }",
            "isBusinessDay": "boolean (date mode); isHoliday; holidays[]; nextBusinessDay",
            "result": "string (days mode) — resulting date; weekday; skipped { weekendDays, holidays }"
          },
          "bodyType": "json",
          "example": {
            "calendar": {
              "country": "US",
              "countryName": "United States of America",
              "source": "date-holidays ruleset (data CC-BY-3.0, attribution required if redistributed)",
              "types": [
                "public"
              ],
              "weekend": [
                "Sunday",
                "Saturday"
              ]
            },
            "days": 3,
            "from": "2026-12-24",
            "result": "2026-12-30",
            "skipped": {
              "holidays": [
                {
                  "date": "2026-12-25",
                  "name": "Christmas Day"
                }
              ],
              "weekendDays": 2
            },
            "weekday": "Wednesday"
          }
        }
      },
      "routeTemplate": "/holidays",
      "schema": {
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "body": {
                "additionalProperties": false,
                "properties": {
                  "country": {
                    "description": "2-letter ISO country code (required).",
                    "type": "string"
                  },
                  "date": {
                    "description": "YYYY-MM-DD — is this date a holiday / business day, and the next business day.",
                    "type": "string"
                  },
                  "days": {
                    "description": "Add this many business days to from (negative to subtract).",
                    "type": "integer"
                  },
                  "from": {
                    "description": "YYYY-MM-DD start date for days/to modes.",
                    "type": "string"
                  },
                  "region": {
                    "description": "Sub-subdivision code where the ruleset has one.",
                    "type": "string"
                  },
                  "state": {
                    "description": "Subdivision code (e.g. CA for US-California, NSW for AU).",
                    "type": "string"
                  },
                  "to": {
                    "description": "YYYY-MM-DD — count business days in [from, to] and list holidays inside.",
                    "type": "string"
                  },
                  "types": {
                    "description": "Holiday types that block a business day (default [public]).",
                    "items": {
                      "enum": [
                        "public",
                        "bank",
                        "school",
                        "optional",
                        "observance"
                      ],
                      "type": "string"
                    },
                    "type": "array"
                  },
                  "weekend": {
                    "description": "Weekend weekdays 0=Sunday…6=Saturday (default [0,6]).",
                    "items": {
                      "type": "integer"
                    },
                    "type": "array"
                  },
                  "year": {
                    "description": "List all holidays in this year (default: current year) when no date/from is given.",
                    "type": "integer"
                  }
                },
                "required": [
                  "country"
                ],
                "type": "object"
              },
              "bodyType": {
                "enum": [
                  "json"
                ],
                "type": "string"
              },
              "method": {
                "enum": [
                  "POST"
                ],
                "type": "string"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method",
              "bodyType",
              "body"
            ],
            "type": "object"
          }
        }
      }
    }
  },
  "tags": [
    "holidays",
    "business-days",
    "calendar",
    "dates",
    "scheduling",
    "bazaar"
  ],
  "sourceHost": "workbot1.oddsys.org",
  "lastUpdated": "2026-10-08T21:36:33.182Z",
  "quality": {
    "calls30d": 3,
    "uniquePayers30d": 3,
    "lastCalledAt": "2026-10-08T21:36:31.2Z"
  },
  "metadata": {
    "serviceName": "Busker Holidays & Business Days",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "body": {
              "country": "US",
              "days": 3,
              "from": "2026-12-24"
            },
            "bodyType": "json",
            "method": "POST",
            "type": "http"
          },
          "output": {
            "body": {
              "businessDays": "number (range mode); calendarDays; holidays[]",
              "calendar": "object — { country, countryName, state?, types, weekend, source }",
              "holidays": "array (year mode) — { date, name, type, substitute? }",
              "isBusinessDay": "boolean (date mode); isHoliday; holidays[]; nextBusinessDay",
              "result": "string (days mode) — resulting date; weekday; skipped { weekendDays, holidays }"
            },
            "bodyType": "json",
            "example": {
              "calendar": {
                "country": "US",
                "countryName": "United States of America",
                "source": "date-holidays ruleset (data CC-BY-3.0, attribution required if redistributed)",
                "types": [
                  "public"
                ],
                "weekend": [
                  "Sunday",
                  "Saturday"
                ]
              },
              "days": 3,
              "from": "2026-12-24",
              "result": "2026-12-30",
              "skipped": {
                "holidays": [
                  {
                    "date": "2026-12-25",
                    "name": "Christmas Day"
                  }
                ],
                "weekendDays": 2
              },
              "weekday": "Wednesday"
            }
          }
        },
        "routeTemplate": "/holidays",
        "schema": {
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "body": {
                  "additionalProperties": false,
                  "properties": {
                    "country": {
                      "description": "2-letter ISO country code (required).",
                      "type": "string"
                    },
                    "date": {
                      "description": "YYYY-MM-DD — is this date a holiday / business day, and the next business day.",
                      "type": "string"
                    },
                    "days": {
                      "description": "Add this many business days to from (negative to subtract).",
                      "type": "integer"
                    },
                    "from": {
                      "description": "YYYY-MM-DD start date for days/to modes.",
                      "type": "string"
                    },
                    "region": {
                      "description": "Sub-subdivision code where the ruleset has one.",
                      "type": "string"
                    },
                    "state": {
                      "description": "Subdivision code (e.g. CA for US-California, NSW for AU).",
                      "type": "string"
                    },
                    "to": {
                      "description": "YYYY-MM-DD — count business days in [from, to] and list holidays inside.",
                      "type": "string"
                    },
                    "types": {
                      "description": "Holiday types that block a business day (default [public]).",
                      "items": {
                        "enum": [
                          "public",
                          "bank",
                          "school",
                          "optional",
                          "observance"
                        ],
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "weekend": {
                      "description": "Weekend weekdays 0=Sunday…6=Saturday (default [0,6]).",
                      "items": {
                        "type": "integer"
                      },
                      "type": "array"
                    },
                    "year": {
                      "description": "List all holidays in this year (default: current year) when no date/from is given.",
                      "type": "integer"
                    }
                  },
                  "required": [
                    "country"
                  ],
                  "type": "object"
                },
                "bodyType": {
                  "enum": [
                    "json"
                  ],
                  "type": "string"
                },
                "method": {
                  "enum": [
                    "POST"
                  ],
                  "type": "string"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method",
                "bodyType",
                "body"
              ],
              "type": "object"
            }
          }
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "workbot1.oddsys.org",
    "manifest_name": "workbot1.oddsys.org",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-14T01:15:01.050Z"
  },
  "exampleResponse": {
    "calendar": {
      "country": "US",
      "countryName": "United States of America",
      "source": "date-holidays ruleset (data CC-BY-3.0, attribution required if redistributed)",
      "types": [
        "public"
      ],
      "weekend": [
        "Sunday",
        "Saturday"
      ]
    },
    "days": 3,
    "from": "2026-12-24",
    "result": "2026-12-30",
    "skipped": {
      "holidays": [
        {
          "date": "2026-12-25",
          "name": "Christmas Day"
        }
      ],
      "weekendDays": 2
    },
    "weekday": "Wednesday"
  }
}