Previous value: -"EuroVoc concept URI to filter by subject (e.g. http://eurovoc.europa.eu/2828), obtained from eurlex_browse_subjects. Omit for no subject filter."New value: +"EuroVoc concept URI to filter by subject (e.g. http://eurovoc.europa.eu/2828), obtained from eurlex_browse_subjects. Only EuroVoc concept URIs are accepted; https://eurovoc.europa.eu/… and an upper-case host are read as the http://eurovoc.europa.eu/… form CELLAR stores. Omit for no subject filter."

Previous value: -"EuroVoc concept URI filter applied."New value: +"EuroVoc concept URI filter applied, in the http://eurovoc.europa.eu/ form it was matched as."

Previous value: -"Author institution name (e.g. \"European Parliament\", \"Council\", \"European Commission\"), matched against the English names of EU corporate bodies."New value: +"Author name (e.g. \"European Parliament\", \"Council\", \"European Commission\"), matched as a phrase against the English labels of each work's authors — the labels eurlex_get_document reports in author_institution(s), member states and MEPs included."

Previous value: -"Keyword matched against English document titles via the full-text index (multi-word input is treated as a phrase), and against CELEX numbers. A keyword that is a whole CELEX (e.g. 32016R0679) matches that document, its numbered siblings (…(01) to …(20)), and for case law its _INF, _RES, _SUM, and _EXT records, plus its corrigenda (…R(01) to …R(20), and any work recorded as correcting it) when include_corrigenda is set. A partial CELEX that opens with the sector and year (02016R0679), the year and type letters (2016R0679), or type letters followed by the number (R0679, J0131) matches every CELEX that holds it at that position, consolidated versions included; one opening with letters not followed by a digit (R(01), ROU_2024) or with a year and a slash (2024/01469) tests every CELEX and can take tens of seconds; a bare year (2016) or a fragment opening mid-year or mid-number (016R0679, 0679, 0679R) matches titles only. A keyword with no digit, or with a character no CELEX holds (a space, a period), matches titles only. A keyword with no letter or digit is rejected."New value: +"Keyword matched against English document titles via the full-text index (multi-word input is treated as a phrase), and against CELEX numbers. A keyword that is a whole CELEX (e.g. 32016R0679) matches that document, its numbered siblings (…(01) to …(20)), and for case law its _INF, _RES, _SUM, and _EXT records, plus its corrigenda (…R(01) to …R(20), and any work recorded as correcting it) when include_corrigenda is set. A partial CELEX that opens with the sector and year (02016R0679), the year and type letters (2016R0679), or type letters followed by the number (R0679, J0131) matches every CELEX that holds it at that position, consolidated versions included; an OJ C fragment of a year, a slash, and at least four characters of the number (2024/01469, C/2024/0146) matches every CELEX holding it; one with a shorter number (2017/111) or opening with letters not followed by a digit (R(01), ROU_2024) tests every CELEX and can take tens of seconds; a bare year (2016) or a fragment opening mid-year or mid-number (016R0679, 0679, 0679R) matches titles only. A keyword with no digit, or with a character no CELEX holds (a space, a period), matches titles only. A keyword with no letter or digit is rejected."

Previous value: -"Keyword matched against English document titles via the full-text index (multi-word input is treated as a phrase), and against CELEX numbers. A keyword that is a whole CELEX (e.g. 32016R0679) matches that document, its numbered siblings (…(01) to …(20)), and for case law its _INF, _RES, _SUM, and _EXT records, plus its corrigenda (…R(01) to …R(20), and any work recorded as correcting it) when include_corrigenda is set; a partial CELEX (e.g. 2016R0679) matches every CELEX containing it. A keyword with no digit, or with a character no CELEX holds (a space, a period), matches titles only. A keyword with no letter or digit is rejected."New value: +"Keyword matched against English document titles via the full-text index (multi-word input is treated as a phrase), and against CELEX numbers. A keyword that is a whole CELEX (e.g. 32016R0679) matches that document, its numbered siblings (…(01) to …(20)), and for case law its _INF, _RES, _SUM, and _EXT records, plus its corrigenda (…R(01) to …R(20), and any work recorded as correcting it) when include_corrigenda is set. A partial CELEX that opens with the sector and year (02016R0679), the year and type letters (2016R0679), or type letters followed by the number (R0679, J0131) matches every CELEX that holds it at that position, consolidated versions included; one opening with letters not followed by a digit (R(01), ROU_2024) or with a year and a slash (2024/01469) tests every CELEX and can take tens of seconds; a bare year (2016) or a fragment opening mid-year or mid-number (016R0679, 0679, 0679R) matches titles only. A keyword with no digit, or with a character no CELEX holds (a space, a period), matches titles only. A keyword with no letter or digit is rejected."

Previous value: -"Restrict by in-force status: true returns only acts currently in force, false only acts no longer in force. Either way the act must carry the in-force property, which a minority of works do. Omit to return all regardless of in-force status."New value: +"Restrict by in-force status: true returns only acts currently in force; false returns acts not in force — repealed, expired, or not yet in force (eurlex_get_document names which, where CELLAR records one). Either way the act must carry the in-force property, which a minority of works do. Omit to return all regardless of in-force status."

Previous value: -"True when this CELEX is a consolidated version — a point-in-time text (…-YYYYMMDD) that incorporates amendments — rather than a base or amending act."New value: +"True when this CELEX is a consolidated version (sector 0, e.g. 02016R0679-20160504) — a point-in-time text that incorporates amendments — rather than a base or amending act."

Previous value: -"Keyword matched against English document titles via the full-text index (multi-word input is treated as a phrase), or against CELEX substrings."New value: +"Keyword matched against English document titles via the full-text index (multi-word input is treated as a phrase), and against CELEX numbers. A keyword that is a whole CELEX (e.g. 32016R0679) matches that document, its numbered siblings (…(01) to …(20)), and for case law its _INF, _RES, _SUM, and _EXT records, plus its corrigenda (…R(01) to …R(20), and any work recorded as correcting it) when include_corrigenda is set; a partial CELEX (e.g. 2016R0679) matches every CELEX containing it. A keyword with no digit, or with a character no CELEX holds (a space, a period), matches titles only. A keyword with no letter or digit is rejected."

Previous value: -"Machine-readable failure mode. Declared by this tool: `no_filters`: No effective narrowing filter was supplied — an unfiltered search would scan the entire corpus. `invalid_date_range`: date_from or date_to is not a real calendar date, or date_from falls after date_to. `no_results`: The first page (offset 0) returned zero bindings — no matching documents in CELLAR. A later page that comes back empty returns an empty success instead. `sparql_error`: Virtuoso returned HTTP 200 with an error body — query malformed or timed out. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_filters`: No effective narrowing filter was supplied — an unfiltered search would scan the entire corpus. `invalid_date_range`: date_from or date_to is not a real calendar date, or date_from falls after date_to. `invalid_author_institution`: author_institution holds no letters or digits, so it can name no institution. `invalid_keyword`: keyword holds no letters or digits, so no title and no CELEX can match it. `sparql_error`: Virtuoso returned HTTP 200 with an error body — query malformed or timed out. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "no_filters",
-  "invalid_date_range",
-  "no_results",
-  "sparql_error"
-]New value: +[
+  "no_filters",
+  "invalid_date_range",
+  "invalid_author_institution",
+  "invalid_keyword",
+  "sparql_error"
+]

Added value: +{
+  "description": "Guidance for the next call: on an empty first page, the filters that matched nothing and how to broaden them; on a page with more rows, the offset to continue from.",
+  "type": "string"
+}

Previous value: -"Matching EU documents ordered by date descending."New value: +"Matching EU documents ordered by date descending, then by CELEX number ascending among documents sharing a date, so pages are stable across calls."

Previous value: -"If true, restrict to acts currently in force. Omit to return all regardless of in-force status."New value: +"Restrict by in-force status: true returns only acts currently in force, false only acts no longer in force. Either way the act must carry the in-force property, which a minority of works do. Omit to return all regardless of in-force status."

Added value: +{
+  "default": false,
+  "description": "Include corrigenda — separate correction works, co-typed CORRIGENDUM alongside the base type of the act they correct, carrying a \"…R(nn)\" CELEX and usually no English title. Default false: they are excluded so primary acts fill the page. Every returned row is tagged is_corrigendum.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "True when this work carries the CORRIGENDUM resource-type — a correction to another act rather than a primary act. Only ever true when include_corrigenda is set, since corrigenda are excluded by default.",
+  "type": "boolean"
+}

Previous value: -[
-  "work_uri",
-  "celex_number",
-  "is_consolidated"
-]New value: +[
+  "work_uri",
+  "celex_number",
+  "is_consolidated",
+  "is_corrigendum"
+]

Added value: +{
+  "description": "Effective include_corrigenda value after the false default is applied — whether corrigenda were admitted alongside primary acts. Always present, since the default shapes which records can appear.",
+  "type": "boolean"
+}

Previous value: -[
-  "include_consolidated"
-]New value: +[
+  "include_consolidated",
+  "include_corrigenda"
+]

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "documents",
-      "total",
-      "offset",
-      "query_echo"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "documents",
+      "total",
+      "offset",
+      "has_more",
+      "query_echo"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Previous value: -"Machine-readable failure mode. Declared by this tool: `no_filters`: No effective narrowing filter was supplied — an unfiltered search would scan the entire corpus. `no_results`: The query returned zero bindings — no matching documents in CELLAR. `sparql_error`: Virtuoso returned HTTP 200 with an error body — query malformed or timed out. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `no_filters`: No effective narrowing filter was supplied — an unfiltered search would scan the entire corpus. `invalid_date_range`: date_from or date_to is not a real calendar date, or date_from falls after date_to. `no_results`: The first page (offset 0) returned zero bindings — no matching documents in CELLAR. A later page that comes back empty returns an empty success instead. `sparql_error`: Virtuoso returned HTTP 200 with an error body — query malformed or timed out. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "no_filters",
-  "no_results",
-  "sparql_error"
-]New value: +[
+  "no_filters",
+  "invalid_date_range",
+  "no_results",
+  "sparql_error"
+]

Added value: +{
+  "description": "True only when CELLAR returned an additional valid row beyond this page.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Offset for the next page. Present only when has_more is true.",
+  "type": "number"
+}

Previous value: -"True when the returned page was capped at the limit and more documents may exist."New value: +"True when an additional CELLAR row proves more documents exist beyond this page."

Previous value: -"Document type: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation. Omit to search all types. A type filter excludes consolidated texts (CONS_TEXT) — set include_consolidated to fold them back in."New value: +"Document category: REG=Regulations, DIR=Directives, DEC=Decisions, TREATY=Treaties, JUDG=Judgments, OPIN_AG=AG Opinions, PROP=Proposals, REC=Recommendations. Each category includes its explicit CELLAR authority variants (for example, delegated and implementing regulations). Omit to search all types. Consolidated texts are excluded unless include_consolidated is true."

Previous value: -"When true and document_type is set, also match consolidated texts (CONS_TEXT) of that type — point-in-time versions that a plain type filter omits. No effect when document_type is omitted. Consolidated rows are always tagged is_consolidated: true."New value: +"When true and document_type is set, also match consolidated texts whose basic act belongs to that document category. No effect when document_type is omitted. Consolidated rows are always tagged is_consolidated: true."

Previous value: -"Effective include_consolidated value after the false default is applied — whether consolidated texts (CONS_TEXT) of the document_type were folded in. Always present, since the default shapes which records can appear; has effect only when document_type is set."New value: +"Effective include_consolidated value after the false default is applied — whether consolidated texts whose basic act belongs to the document_type category were included. Always present, since the default shapes which records can appear; has effect only when document_type is set."

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +false

Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "documents",
+      "total",
+      "offset",
+      "query_echo"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `no_filters`: No effective narrowing filter was supplied — an unfiltered search would scan the entire corpus. `no_results`: The query returned zero bindings — no matching documents in CELLAR. `sparql_error`: Virtuoso returned HTTP 200 with an error body — query malformed or timed out. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "no_filters",
+            "no_results",
+            "sparql_error"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "documents",
-  "total",
-  "offset",
-  "query_echo"
-]

Added value: +{
+  "description": "Effective include_consolidated value after the false default is applied — whether consolidated texts (CONS_TEXT) of the document_type were folded in. Always present, since the default shapes which records can appear; has effect only when document_type is set.",
+  "type": "boolean"
+}

Added value: +[
+  "include_consolidated"
+]

Previous value: -[
-  {
-    "const": "",
-    "type": "string"
-  },
-  {
-    "description": "EuroVoc concept URI (e.g. http://eurovoc.europa.eu/2828).",
-    "pattern": "^http.*",
-    "type": "string"
-  }
-]New value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "EuroVoc concept URI (e.g. http://eurovoc.europa.eu/2828).",
+    "type": "string"
+  }
+]

Previous value: -"Author institution name (e.g. \"European Parliament\", \"Council\", \"European Commission\"). Matched against the English names of EU corporate bodies; only works created by a matching institution are returned."New value: +"Author institution name (e.g. \"European Parliament\", \"Council\", \"European Commission\"), matched against the English names of EU corporate bodies."

Previous value: -"Start of date range in ISO 8601 format (YYYY-MM-DD). Matches document date. Leave blank or omit for no lower bound."New value: +"Start of date range (YYYY-MM-DD), matched against document date. Omit for no lower bound."

Previous value: -"End of date range in ISO 8601 format (YYYY-MM-DD). Matches document date. Leave blank or omit for no upper bound."New value: +"End of date range (YYYY-MM-DD), matched against document date. Omit for no upper bound."

Previous value: -"Document type filter: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation. Leave blank or omit to search all document types. A type filter excludes consolidated texts (CONS_TEXT), which carry their own resource-type — set include_consolidated to fold them back in."New value: +"Document type: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation. Omit to search all types. A type filter excludes consolidated texts (CONS_TEXT) — set include_consolidated to fold them back in."

Previous value: -"EuroVoc concept URI to filter by subject (e.g. http://eurovoc.europa.eu/2828). Obtain concept URIs from eurlex_browse_subjects first. Leave blank or omit for no subject filter."New value: +"EuroVoc concept URI to filter by subject (e.g. http://eurovoc.europa.eu/2828), obtained from eurlex_browse_subjects. Omit for no subject filter."

Previous value: -"When true and document_type is set, also match consolidated texts (CONS_TEXT) of that type — point-in-time versions that incorporate later amendments and carry their own resource-type, so a plain type filter omits them. No effect when document_type is omitted (all types already return). Either way, consolidated rows are tagged is_consolidated: true."New value: +"When true and document_type is set, also match consolidated texts (CONS_TEXT) of that type — point-in-time versions that a plain type filter omits. No effect when document_type is omitted. Consolidated rows are always tagged is_consolidated: true."

Previous value: -"Human-readable document type label (e.g. \"Regulation\", \"Directive\"). Works classified under several resource-types (e.g. corrigenda) list all labels, comma-separated. Absent for some older works."New value: +"Human-readable document type label (e.g. \"Regulation\", \"Directive\"). Works with several resource-types (e.g. corrigenda) list all, comma-separated. Absent for some older works."

Previous value: -"Document type filter: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation. Leave blank or omit to search all document types."New value: +"Document type filter: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation. Leave blank or omit to search all document types. A type filter excludes consolidated texts (CONS_TEXT), which carry their own resource-type — set include_consolidated to fold them back in."

Added value: +{
+  "default": false,
+  "description": "When true and document_type is set, also match consolidated texts (CONS_TEXT) of that type — point-in-time versions that incorporate later amendments and carry their own resource-type, so a plain type filter omits them. No effect when document_type is omitted (all types already return). Either way, consolidated rows are tagged is_consolidated: true.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "The limit that was applied to this page.",
+  "type": "number"
+}

Added value: +{
+  "description": "True when this CELEX is a consolidated version — a point-in-time text (…-YYYYMMDD) that incorporates amendments — rather than a base or amending act.",
+  "type": "boolean"
+}

Previous value: -[
-  "work_uri",
-  "celex_number"
-]New value: +[
+  "work_uri",
+  "celex_number",
+  "is_consolidated"
+]

Added value: +{
+  "description": "Number of documents returned in this page.",
+  "type": "number"
+}

Added value: +{
+  "description": "True when the returned page was capped at the limit and more documents may exist.",
+  "type": "boolean"
+}

Previous value: -"Keyword to match against document titles. Single dominant word recommended; multi-word phrase uses substring match."New value: +"Keyword matched against English document titles via the full-text index (multi-word input is treated as a phrase), or against CELEX substrings."

Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "Start date in ISO 8601 format (YYYY-MM-DD).",
+    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+    "type": "string"
+  }
+]

Previous value: -"Start of date range in ISO 8601 format (YYYY-MM-DD). Matches document date."New value: +"Start of date range in ISO 8601 format (YYYY-MM-DD). Matches document date. Leave blank or omit for no lower bound."

Removed value: -"^\\d{4}-\\d{2}-\\d{2}$"

Removed value: -"string"

Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "End date in ISO 8601 format (YYYY-MM-DD).",
+    "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+    "type": "string"
+  }
+]

Previous value: -"End of date range in ISO 8601 format (YYYY-MM-DD). Matches document date."New value: +"End of date range in ISO 8601 format (YYYY-MM-DD). Matches document date. Leave blank or omit for no upper bound."

Removed value: -"^\\d{4}-\\d{2}-\\d{2}$"

Removed value: -"string"

Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "Document type: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation.",
+    "enum": [
+      "REG",
+      "DIR",
+      "DEC",
+      "TREATY",
+      "JUDG",
+      "OPIN_AG",
+      "PROP",
+      "REC"
+    ],
+    "type": "string"
+  }
+]

Previous value: -"Document type filter: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation."New value: +"Document type filter: REG=Regulation, DIR=Directive, DEC=Decision, TREATY=Treaty, JUDG=Judgment, OPIN_AG=AG Opinion, PROP=Proposal, REC=Recommendation. Leave blank or omit to search all document types."

Removed value: -[
-  "REG",
-  "DIR",
-  "DEC",
-  "TREATY",
-  "JUDG",
-  "OPIN_AG",
-  "PROP",
-  "REC"
-]

Removed value: -"string"

Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "EuroVoc concept URI (e.g. http://eurovoc.europa.eu/2828).",
+    "pattern": "^http.*",
+    "type": "string"
+  }
+]

Previous value: -"EuroVoc concept URI to filter by subject (e.g. http://eurovoc.europa.eu/2828). Obtain concept URIs from eurlex_browse_subjects first."New value: +"EuroVoc concept URI to filter by subject (e.g. http://eurovoc.europa.eu/2828). Obtain concept URIs from eurlex_browse_subjects first. Leave blank or omit for no subject filter."

Removed value: -"^http.*"

Removed value: -"string"

Previous value: -"Human-readable document type label (e.g. \"Regulation\", \"Directive\"). Absent for some older works."New value: +"Human-readable document type label (e.g. \"Regulation\", \"Directive\"). Works classified under several resource-types (e.g. corrigenda) list all labels, comma-separated. Absent for some older works."

Previous value: -"Author institution name filter (e.g. \"European Parliament\", \"Council\"). Substring match."New value: +"Author institution name (e.g. \"European Parliament\", \"Council\", \"European Commission\"). Matched against the English names of EU corporate bodies; only works created by a matching institution are returned."