lookup-holiday

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['country'], 'properties': {'year': {'type': 'integer', 'maximum': 2200, 'minimum': 1900, 'description': 'Calendar year to look up. Defaults to the current UTC year. Between 1900 and 2200.'}, 'state': {'type': 'string', 'description': 'Optional subdivision code within the country (e.g. "CA" for California in "US").'}, 'types': {'type': 'array', 'items': {'enum': ['public', 'bank', 'school', 'optional', 'observance'], 'type': 'string'}, 'description': 'Optional filter: only return holidays of these types (e.g. ["public"]). Default: all types.'}, 'region': {'type': 'string', 'description': 'Optional sub-region code within the state. Requires `state` to also be set.'}, 'country': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': 'ISO 3166-1 alpha-2 country code (e.g. "US", "FR", "JP").'}, 'language': {'type': 'string', 'description': 'Optional ISO 639-1 language code for holiday names (e.g. "es"). Falls back to the country default.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['valid', 'error', 'country', 'state', 'region', 'year', 'holidays'], 'properties': {'year': {'type': 'number'}, 'error': {'anyOf': [{'type': 'string'}, {'type': 'null'}], 'description': 'Error message if valid is false; null otherwise.'}, 'state': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'valid': {'type': 'boolean', 'description': 'false if the input (country/state/region/year/type) was invalid.'}, 'region': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'country': {'type': 'string'}, 'holidays': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'name', 'type', 'substitute'], 'properties': {'date': {'type': 'string', 'description': 'ISO date (YYYY-MM-DD) of the holiday.'}, 'name': {'type': 'string'}, 'type': {'enum': ['public', 'bank', 'school', 'optional', 'observance'], 'type': 'string'}, 'substitute': {'type': 'boolean', 'description': 'true if this entry is a substitute day for a holiday that fell on a weekend.'}}, 'additionalProperties': False}, 'description': 'Holidays for the requested year, sorted by date.'}}, 'additionalProperties': False}