{"contract_version":"2026-09-05.regulations-query.v2","resource":"regulations","path":"/regulations","composition":"AND across supplied dimensions; newest records first within the filtered corpus","search":{"parameter":"q","semantics":"PostgreSQL English web-search over the published Atlas search index","maximum_characters":200},"exact_dimensions":["jurisdiction","subdivision","vertical","authority_id","authority_name","action_type","lifecycle_stage","significance","regulatory_event_type","source_domain"],"numeric_bounds":["min_event_severity"],"date_ranges":["published_from/published_to","effective_from/effective_to","updated_from/updated_to"],"incremental_sync":{"changed_since_parameter":"updated_from","legacy_alias":"updated_since","cursor_parameter":"cursor","checkpoint_rule":"Persist next_cursor only after the local transaction commits."},"freshness":{"contract_version":"2026-08-28.regulatory-freshness.v1","request_parameters":{"mode":"freshness_mode","max_age_seconds":"freshness_max_age_seconds"},"modes":{"standard":{"behavior":"Return the current published Atlas record with exact source-check evidence when available.","fails_when_evidence_is_stale_or_unknown":false},"require_fresh":{"behavior":"Fail the complete read when any returned record lacks a successful ordinary source-check receipt inside the requested age window.","fails_when_evidence_is_stale_or_unknown":true},"refresh_if_stale":{"supported":true,"behavior":"Use POST /freshness/refresh-jobs with an Idempotency-Key. A GET read never silently starts model work or authorizes delivery."}},"defaults":{"mode":"standard","max_age_seconds":93600},"bounds":{"minimum_max_age_seconds":60,"maximum_max_age_seconds":2592000},"evidence_semantics":{"source_checked_at":"Newest append-only ordinary queue-scan audit receipt for the exact source bound to the regulation.","atlas_record_updated_at":"Atlas publication-row change time. It is not represented as a source-check receipt.","customer_published_at":"Customer publication time. It is not represented as a source-check receipt."},"safety":{"customer_safe":true,"delivery_authorized":false,"ai_on_read":false}},"response_dimensions":{"contract_version":"2026-09-05.regulatory-data-dimensions.v2","fields":["jurisdiction_codes","jurisdiction_names","subdivisions","verticals","categories","topics","document_types","lifecycle_stages","materiality","authority_ids","authority_names","source_authority_ids","source_authority_names"]},"examples":[{"question":"What EU AI consultations changed since my last sync?","request":"/regulations?q=consultation&jurisdiction=EU&vertical=AI&updated_from=2026-08-01T00:00:00Z"},{"question":"What actionable payments items did this authority publish this month?","request":"/regulations?authority_id={uuid}&vertical=Payments&significance=Actionable&published_from=2026-08-01"},{"question":"Which material changes take effect next quarter?","request":"/regulations?min_event_severity=3&effective_from=2026-10-01&effective_to=2026-12-31"}],"safety":{"published_only":true,"customer_safe_projection":true,"delivery_authorized":false,"note":"A query result never authorizes Slack or another delivery action."}}