DatoQA — Official Public Holidays

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'language': {'enum': ['en', 'fr'], 'type': 'string', 'default': 'en'}, 'report_to': {'type': 'integer', 'maximum': 2025, 'minimum': -9007199254740991}, 'report_from': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1960}, 'report_countries': {'type': 'array', 'items': {'type': 'string', 'pattern': '^[A-Z0-9]{3}$'}, 'maxItems': 10, 'minItems': 1, 'description': 'Optional free preview for these distinct World Bank country codes, e.g. FRA, DEU, ESP. General/economy connections only.'}, 'report_indicators': {'type': 'array', 'items': {'enum': ['population', 'gdp', 'gdp_per_capita', 'gdp_real', 'gdp_growth', 'inflation', 'life_expectancy', 'fertility', 'urban_population', 'internet_users', 'electricity_access', 'unemployment', 'renewable_energy', 'forest_area', 'agricultural_land', 'trade', 'exports', 'imports', 'infant_mortality', 'basic_drinking_water', 'basic_sanitation', 'primary_completion'], 'type': 'string'}, 'maxItems': 6, 'minItems': 1, 'description': 'Custom historical comparison: select up to six of the 22 WDI indicators. Supply report_from and report_to together, up to ten years. Missing cells block payment.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['name'], 'properties': {'name': {'type': 'string', 'const': 'DatoQA'}, 'title': {'type': 'string'}, 'tools': {'type': 'array', 'items': {'type': 'string'}}, 'profile': {'type': 'string'}, 'version': {'type': 'string'}, 'capabilities': {'type': 'array', 'items': {'type': 'string'}}, 'available_records': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'independently_verified': {'type': 'boolean', 'const': False, 'description': 'Official-source checks are not independent factual corroboration.'}}, 'description': 'General availability catalog or a scoped thematic directory; theme metadata is not a live availability guarantee.', 'additionalProperties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]{1,128}$', 'description': 'Record id returned by a DatoQA data response; returns the retained source snapshot for that record.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['record_id', 'sha256', 'hash_scope', 'source_payload_json', 'first_observed_at', 'source_url', 'notice'], 'properties': {'notice': {'type': 'string'}, 'sha256': {'type': 'string'}, 'record_id': {'type': 'string'}, 'hash_scope': {'type': 'string', 'const': 'utf8_source_payload_json'}, 'source_url': {'type': 'string'}, 'first_observed_at': {'type': 'string'}, 'source_payload_json': {'type': 'string'}}, 'additionalProperties': False}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['region'], 'properties': {'date': {'type': 'string', 'description': 'Exact local calendar date YYYY-MM-DD, for example 2026-12-28; cannot be combined with year.'}, 'year': {'type': 'integer', 'maximum': 2032, 'minimum': 2000, 'description': 'Calendar year; defaults to the current year. Only published years are available. Omit when date is supplied.'}, 'region': {'enum': ['fr-metropole', 'fr-alsace-moselle', 'fr-guadeloupe', 'fr-guyane', 'fr-la-reunion', 'fr-martinique', 'fr-mayotte', 'fr-nouvelle-caledonie', 'fr-polynesie-francaise', 'fr-saint-barthelemy', 'fr-saint-martin', 'fr-saint-pierre-et-miquelon', 'fr-wallis-et-futuna', 'gb-england-and-wales', 'gb-scotland', 'gb-northern-ireland', 'hk-general', 'oh-ad', 'oh-al', 'oh-at', 'oh-be', 'oh-bg', 'oh-br', 'oh-by', 'oh-ch', 'oh-cz', 'oh-de', 'oh-ee', 'oh-es', 'oh-fr', 'oh-hr', 'oh-hu', 'oh-ie', 'oh-it', 'oh-li', 'oh-lt', 'oh-lu', 'oh-lv', 'oh-mc', 'oh-md', 'oh-mt', 'oh-mx', 'oh-nl', 'oh-pl', 'oh-pt', 'oh-ro', 'oh-rs', 'oh-se', 'oh-si', 'oh-sk', 'oh-sm', 'oh-va', 'oh-za'], 'type': 'string', 'description': 'Calendar identifier from list_holiday_regions, for example gb-england-and-wales.'}, 'nationwide_only': {'type': 'boolean', 'description': 'For OpenHolidays country calendars, keep only entries marked nationwide by the source. Default false includes regional entries with their scopes. Government calendars retain their named territory scope.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['status', 'returned', 'items'], 'properties': {'year': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}, 'items': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'domain', 'data', 'freshness', 'citation', 'provenance'], 'properties': {'id': {'type': 'string'}, 'data': {'type': 'object', 'description': 'Source-specific payload; inspect units, observation dates, nulls and source notes.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'domain': {'type': 'string'}, 'citation': {'type': 'object', 'required': ['url', 'publisher', 'retrieved_at'], 'properties': {'url': {'type': 'string'}, 'publisher': {'type': 'string'}, 'retrieved_at': {'type': 'string'}}, 'additionalProperties': False}, 'freshness': {'type': 'object', 'required': ['observed_at', 'expires_at', 'age_seconds', 'meaning'], 'properties': {'meaning': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'age_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'observed_at': {'type': 'string'}}, 'additionalProperties': False}, 'provenance': {'type': 'object', 'required': ['source_id', 'source_name', 'source_url', 'license', 'retrieved_at', 'verified_at', 'valid_until', 'verification_method', 'content_sha256', 'verification_level', 'independently_verified', 'verification_scope'], 'properties': {'license': {'type': 'string'}, 'source_id': {'type': 'string'}, 'source_url': {'type': 'string'}, 'source_name': {'type': 'string'}, 'valid_until': {'type': 'string'}, 'verified_at': {'type': 'string'}, 'retrieved_at': {'type': 'string'}, 'content_sha256': {'type': 'string'}, 'verification_level': {'enum': ['official_source_and_schema_checked', 'public_aggregator_and_schema_checked', 'method_specific'], 'type': 'string'}, 'verification_scope': {'type': 'array', 'items': {'type': 'string'}}, 'verification_method': {'type': 'string'}, 'independently_verified': {'type': 'boolean', 'const': False, 'description': 'Official-source checks are not independent factual corroboration.'}}, 'additionalProperties': False}, 'display_label': {'type': 'string'}}, 'additionalProperties': {}}}, 'notice': {'type': 'string'}, 'region': {'type': 'string'}, 'status': {'enum': ['source_unavailable_or_stale', 'year_not_covered', 'holidays_listed', 'no_holiday_listed_for_date'], 'type': 'string', 'description': 'Read this before using values; a successful transport does not establish data availability.'}, 'returned': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Domain-specific result count, not necessarily the number of stored records in items.'}, 'directory': {'type': 'string'}, 'requested_date': {'type': ['string', 'null']}, 'available_years': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'independently_verified': {'type': 'boolean', 'const': False, 'description': 'Official-source checks are not independent factual corroboration.'}}, 'additionalProperties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id'], 'properties': {'id': {'type': 'string', 'pattern': '^[A-Za-z0-9_-]+$', 'maxLength': 128, 'minLength': 1, 'description': 'Opaque record id returned by a DatoQA data response. Reuse it exactly; do not invent an id.'}}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['id', 'domain', 'data', 'freshness', 'citation', 'provenance'], 'properties': {'id': {'type': 'string'}, 'data': {'type': 'object', 'description': 'Source-specific payload; inspect units, observation dates, nulls and source notes.', 'propertyNames': {'type': 'string'}, 'additionalProperties': {}}, 'domain': {'type': 'string'}, 'citation': {'type': 'object', 'required': ['url', 'publisher', 'retrieved_at'], 'properties': {'url': {'type': 'string'}, 'publisher': {'type': 'string'}, 'retrieved_at': {'type': 'string'}}, 'additionalProperties': False}, 'freshness': {'type': 'object', 'required': ['observed_at', 'expires_at', 'age_seconds', 'meaning'], 'properties': {'meaning': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'age_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'observed_at': {'type': 'string'}}, 'additionalProperties': False}, 'provenance': {'type': 'object', 'required': ['source_id', 'source_name', 'source_url', 'license', 'retrieved_at', 'verified_at', 'valid_until', 'verification_method', 'content_sha256', 'verification_level', 'independently_verified', 'verification_scope'], 'properties': {'license': {'type': 'string'}, 'source_id': {'type': 'string'}, 'source_url': {'type': 'string'}, 'source_name': {'type': 'string'}, 'valid_until': {'type': 'string'}, 'verified_at': {'type': 'string'}, 'retrieved_at': {'type': 'string'}, 'content_sha256': {'type': 'string'}, 'verification_level': {'enum': ['official_source_and_schema_checked', 'public_aggregator_and_schema_checked', 'method_specific'], 'type': 'string'}, 'verification_scope': {'type': 'array', 'items': {'type': 'string'}}, 'verification_method': {'type': 'string'}, 'independently_verified': {'type': 'boolean', 'const': False, 'description': 'Official-source checks are not independent factual corroboration.'}}, 'additionalProperties': False}, 'display_label': {'type': 'string'}}, 'additionalProperties': {}}

{'type': 'object', 'properties': {}}

{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['endpoint', 'regions', 'configured_regions', 'region_count', 'source_event_count', 'count_meaning', 'refresh_interval_seconds', 'max_collection_age_seconds', 'notice', 'independently_verified'], 'properties': {'notice': {'type': 'string'}, 'regions': {'type': 'array', 'items': {'type': 'object', 'required': ['region', 'name', 'country_code', 'years', 'source_event_count', 'retrieved_at', 'expires_at'], 'properties': {'name': {'type': 'string'}, 'years': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991}}, 'region': {'type': 'string'}, 'expires_at': {'type': 'string'}, 'source_kind': {'type': 'string'}, 'country_code': {'type': 'string'}, 'retrieved_at': {'type': 'string'}, 'date_confirmation': {'type': 'string'}, 'source_event_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}}, 'endpoint': {'type': 'string'}, 'region_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'count_meaning': {'type': 'string'}, 'configured_regions': {'type': 'array', 'items': {'type': 'object', 'required': ['region', 'name'], 'properties': {'name': {'type': 'string'}, 'region': {'type': 'string'}}, 'additionalProperties': False}}, 'source_event_count': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'independently_verified': {'type': 'boolean', 'const': False, 'description': 'Official-source checks are not independent factual corroboration.'}, 'refresh_interval_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'max_collection_age_seconds': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}}, 'additionalProperties': False}