Payments Law — EU payments legislation

Read EU legislative provision

get_provision

Read-onlyIdempotent

Use this to read or quote an EU legislative provision, such as PSD2 Article 97 or RTS-SCA Article 5. Returns the source text of an article, annex or recital as markdown (a sub- or superscript with no Unicode form as inline /), with its cite anchor, provenance and text-state disclosure. Large provisions paginate by structural block — never truncated silently. version_id is optional: the service serves one text per instrument, and a pinned version id is refused with the URL where it is published. include_correspondences adds the cross-instrument article equivalences — what a PSR article is amended from, or which PSR articles carry a PSD2 article's obligation — each openable by a second call.

Input Schema

TableJSON Schema

Name	Required	Description
`cursor`	No	Continue a paginated provision. Bound to the release.
`locator`	Yes
`on_date`	No	ISO date; returns the provision-level applicability view.
`version_id`	No	Omit, or pass "current", for the served text. A pinned version id returns version_not_served with the URL where that text is published.
`instrument_id`	Yes	Registry id of the instrument, e.g. "psd-2".
`include_correspondences`	No	Off by default. When true, an article carries `correspondences[]`: the cross-instrument article equivalences the corpus publishes — which PSD2 article a PSR article is amended from, and, from the other side, which PSR articles carry a PSD2 article's obligation. Each entry names the counterpart's own `get_provision` locator, version and cite anchor, so it opens with a second call. The relationship vocabulary is the analysis layer's own — `amended_from`, `supersedes` — plus the mechanical inverses of the reverse view, `amended_into` and `superseded_by`. An annex or a recital carries an empty list: correspondences are article-level: a request narrowed to a paragraph or a point still receives the whole article's mappings, and says so in a warning. `null` means the release predates the mapping table, which is not the same as an article having none. Where the corpus records a mapping this service will not serve — a correlation-table entry numbered against a superseded draft, or a counterpart absent from the served text — the list omits it and a `correspondence_withheld` warning names the instrument and the reason, so an empty or short list is never silently under-claimed.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`data`	Yes
`error`	Yes
`coverage`	Yes
`warnings`	Yes
`pagination`	Yes
`provenance`	Yes
`derivations`	Yes
`corpus_release`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 6, 2026

changedOutput schema / properties / data / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "blocks_in_page": {
-        "type": "number"
-      },
-      "blocks_in_provision": {
-        "type": "number"
-      },
-      "blocks_total": {
-        "type": "number"
-      },
-      "cite": {
-        "type": "string"
-      },
-      "content_hash": {
-        "type": "string"
-      },
-      "correspondences": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "derivation": {
-                  "type": "string"
-                },
-                "note": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "relationship": {
-                  "type": "string"
-                },
-                "target": {
-                  "additionalProperties": {},
-                  "properties": {
-                    "cite": {
-                      "type": "string"
-                    },
-                    "instrument_id": {
-                      "type": "string"
-                    },
-                    "locator": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "annex": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered."
-                        },
-                        "article": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\"."
-                        },
-                        "kind": {
-                          "description": "Which kind of provision the locator names.",
-                          "enum": [
-                            "article",
-                            "annex",
-                            "recital"
-                          ],
-                          "type": "string"
-                        },
-                        "paragraph": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Numbered paragraph within the article, e.g. \"2\"."
-                        },
-                        "point": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Lettered point within the paragraph, e.g. \"b\"."
-                        },
-                        "recital": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Recital number, e.g. \"95\"."
-                        },
-                        "subpoint": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Sub-point within the point."
-                        }
-                      },
-                      "required": [
-                        "kind"
-                      ],
-                      "type": "object"
-                    },
-                    "url": {
-                      "type": "string"
-                    },
-                    "version_id": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "instrument_id",
-                    "version_id",
-                    "cite",
-                    "url",
-                    "locator"
-                  ],
-                  "type": "object"
-                }
-              },
-              "required": [
-                "relationship",
-                "derivation",
-                "note",
-                "target"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "deletions": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": false,
-              "properties": {
-                "act": {
-                  "type": "string"
-                },
-                "celex": {
-                  "type": "string"
-                },
-                "form": {
-                  "type": "string"
-                },
-                "instrument_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "marker": {
-                  "type": "string"
-                },
-                "position": {
-                  "enum": [
-                    "within",
-                    "after",
-                    "title"
-                  ],
-                  "type": "string"
-                }
-              },
-              "required": [
-                "celex",
-                "marker",
-                "form",
-                "position",
-                "act",
-                "instrument_id"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "EUR-Lex deletion stubs on the whole provision, in source order, each with the act that deleted what stood there. \"within\": the nth \"—————\" in the provision text; \"after\": something deleted after this provision (a whole article or chapter); \"title\": in its heading. Mechanically derived from the stub's own EUR-Lex pointer; not part of the legal text. Null means the release predates the record (see the typed warning), never that nothing was deleted."
-      },
-      "instrument_id": {
-        "type": "string"
-      },
-      "kind": {
-        "type": "string"
-      },
-      "markdown": {
-        "type": "string"
-      },
-      "narrowed": {
-        "type": "boolean"
-      },
-      "source_notes": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "complete": {
-                "const": true,
-                "description": "All notes referenced in this response's text, not the whole document or later pages.",
-                "type": "boolean"
-              },
-              "items": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "marker": {
-                      "type": "string"
-                    },
-                    "text": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key",
-                    "marker",
-                    "text"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "scope": {
-                "const": "returned_text",
-                "type": "string"
-              },
-              "source_version_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "scope",
-              "source_version_id",
-              "complete",
-              "items"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
-      },
-      "url": {
-        "type": "string"
-      },
-      "version_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "instrument_id",
-      "version_id",
-      "cite",
-      "kind",
-      "markdown",
-      "source_notes",
-      "deletions",
-      "narrowed",
-      "blocks_in_page",
-      "blocks_total",
-      "blocks_in_provision",
-      "content_hash",
-      "url"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "blocks_in_page": {
+        "type": "number"
+      },
+      "blocks_in_provision": {
+        "type": "number"
+      },
+      "blocks_total": {
+        "type": "number"
+      },
+      "cite": {
+        "type": "string"
+      },
+      "content_hash": {
+        "type": "string"
+      },
+      "correspondences": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "derivation": {
+                  "type": "string"
+                },
+                "note": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "relationship": {
+                  "type": "string"
+                },
+                "target": {
+                  "additionalProperties": {},
+                  "properties": {
+                    "cite": {
+                      "type": "string"
+                    },
+                    "instrument_id": {
+                      "type": "string"
+                    },
+                    "locator": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "annex": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered."
+                        },
+                        "article": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\"."
+                        },
+                        "kind": {
+                          "description": "Which kind of provision the locator names.",
+                          "enum": [
+                            "article",
+                            "annex",
+                            "recital"
+                          ],
+                          "type": "string"
+                        },
+                        "paragraph": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Numbered paragraph within the article, e.g. \"2\"."
+                        },
+                        "point": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Lettered point within the paragraph, e.g. \"b\"."
+                        },
+                        "recital": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Recital number, e.g. \"95\"."
+                        },
+                        "subpoint": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Sub-point within the point."
+                        }
+                      },
+                      "required": [
+                        "kind"
+                      ],
+                      "type": "object"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "version_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "instrument_id",
+                    "version_id",
+                    "cite",
+                    "url",
+                    "locator"
+                  ],
+                  "type": "object"
+                }
+              },
+              "required": [
+                "relationship",
+                "derivation",
+                "note",
+                "target"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "deletions": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "act": {
+                  "type": "string"
+                },
+                "celex": {
+                  "type": "string"
+                },
+                "form": {
+                  "type": "string"
+                },
+                "heading": {
+                  "type": "string"
+                },
+                "instrument_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "marker": {
+                  "type": "string"
+                },
+                "position": {
+                  "enum": [
+                    "within",
+                    "after",
+                    "title"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "celex",
+                "marker",
+                "form",
+                "position",
+                "act",
+                "instrument_id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "EUR-Lex deletion stubs on the whole provision, in source order, each with the act that deleted what stood there. \"within\": the nth \"—————\" in the provision text; \"after\": something deleted after this provision (a whole article or chapter), with `heading` naming the Title, Chapter or Section heading it stands under when one comes between them; \"title\": in its heading. Mechanically derived from the stub's own EUR-Lex pointer; not part of the legal text. Null means the release predates the record (see the typed warning), never that nothing was deleted."
+      },
+      "instrument_id": {
+        "type": "string"
+      },
+      "kind": {
+        "type": "string"
+      },
+      "markdown": {
+        "type": "string"
+      },
+      "narrowed": {
+        "type": "boolean"
+      },
+      "source_notes": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "complete": {
+                "const": true,
+                "description": "All notes referenced in this response's text, not the whole document or later pages.",
+                "type": "boolean"
+              },
+              "items": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "marker": {
+                      "type": "string"
+                    },
+                    "text": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key",
+                    "marker",
+                    "text"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "scope": {
+                "const": "returned_text",
+                "type": "string"
+              },
+              "source_version_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "scope",
+              "source_version_id",
+              "complete",
+              "items"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
+      },
+      "url": {
+        "type": "string"
+      },
+      "version_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "instrument_id",
+      "version_id",
+      "cite",
+      "kind",
+      "markdown",
+      "source_notes",
+      "deletions",
+      "narrowed",
+      "blocks_in_page",
+      "blocks_total",
+      "blocks_in_provision",
+      "content_hash",
+      "url"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed1 schema field changedOct 5, 2026

changedOutput schema / properties / data / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "blocks_in_page": {
-        "type": "number"
-      },
-      "blocks_in_provision": {
-        "type": "number"
-      },
-      "blocks_total": {
-        "type": "number"
-      },
-      "cite": {
-        "type": "string"
-      },
-      "content_hash": {
-        "type": "string"
-      },
-      "correspondences": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "derivation": {
-                  "type": "string"
-                },
-                "note": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "relationship": {
-                  "type": "string"
-                },
-                "target": {
-                  "additionalProperties": {},
-                  "properties": {
-                    "cite": {
-                      "type": "string"
-                    },
-                    "instrument_id": {
-                      "type": "string"
-                    },
-                    "locator": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "annex": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered."
-                        },
-                        "article": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\"."
-                        },
-                        "kind": {
-                          "description": "Which kind of provision the locator names.",
-                          "enum": [
-                            "article",
-                            "annex",
-                            "recital"
-                          ],
-                          "type": "string"
-                        },
-                        "paragraph": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Numbered paragraph within the article, e.g. \"2\"."
-                        },
-                        "point": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Lettered point within the paragraph, e.g. \"b\"."
-                        },
-                        "recital": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Recital number, e.g. \"95\"."
-                        },
-                        "subpoint": {
-                          "anyOf": [
-                            {
-                              "maxLength": 32,
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Sub-point within the point."
-                        }
-                      },
-                      "required": [
-                        "kind"
-                      ],
-                      "type": "object"
-                    },
-                    "url": {
-                      "type": "string"
-                    },
-                    "version_id": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "instrument_id",
-                    "version_id",
-                    "cite",
-                    "url",
-                    "locator"
-                  ],
-                  "type": "object"
-                }
-              },
-              "required": [
-                "relationship",
-                "derivation",
-                "note",
-                "target"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "instrument_id": {
-        "type": "string"
-      },
-      "kind": {
-        "type": "string"
-      },
-      "markdown": {
-        "type": "string"
-      },
-      "narrowed": {
-        "type": "boolean"
-      },
-      "source_notes": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "complete": {
-                "const": true,
-                "description": "All notes referenced in this response's text, not the whole document or later pages.",
-                "type": "boolean"
-              },
-              "items": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "marker": {
-                      "type": "string"
-                    },
-                    "text": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key",
-                    "marker",
-                    "text"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "scope": {
-                "const": "returned_text",
-                "type": "string"
-              },
-              "source_version_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "scope",
-              "source_version_id",
-              "complete",
-              "items"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
-      },
-      "url": {
-        "type": "string"
-      },
-      "version_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "instrument_id",
-      "version_id",
-      "cite",
-      "kind",
-      "markdown",
-      "source_notes",
-      "narrowed",
-      "blocks_in_page",
-      "blocks_total",
-      "blocks_in_provision",
-      "content_hash",
-      "url"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "blocks_in_page": {
+        "type": "number"
+      },
+      "blocks_in_provision": {
+        "type": "number"
+      },
+      "blocks_total": {
+        "type": "number"
+      },
+      "cite": {
+        "type": "string"
+      },
+      "content_hash": {
+        "type": "string"
+      },
+      "correspondences": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "derivation": {
+                  "type": "string"
+                },
+                "note": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "relationship": {
+                  "type": "string"
+                },
+                "target": {
+                  "additionalProperties": {},
+                  "properties": {
+                    "cite": {
+                      "type": "string"
+                    },
+                    "instrument_id": {
+                      "type": "string"
+                    },
+                    "locator": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "annex": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered."
+                        },
+                        "article": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\"."
+                        },
+                        "kind": {
+                          "description": "Which kind of provision the locator names.",
+                          "enum": [
+                            "article",
+                            "annex",
+                            "recital"
+                          ],
+                          "type": "string"
+                        },
+                        "paragraph": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Numbered paragraph within the article, e.g. \"2\"."
+                        },
+                        "point": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Lettered point within the paragraph, e.g. \"b\"."
+                        },
+                        "recital": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Recital number, e.g. \"95\"."
+                        },
+                        "subpoint": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Sub-point within the point."
+                        }
+                      },
+                      "required": [
+                        "kind"
+                      ],
+                      "type": "object"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "version_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "instrument_id",
+                    "version_id",
+                    "cite",
+                    "url",
+                    "locator"
+                  ],
+                  "type": "object"
+                }
+              },
+              "required": [
+                "relationship",
+                "derivation",
+                "note",
+                "target"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "deletions": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": false,
+              "properties": {
+                "act": {
+                  "type": "string"
+                },
+                "celex": {
+                  "type": "string"
+                },
+                "form": {
+                  "type": "string"
+                },
+                "instrument_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "marker": {
+                  "type": "string"
+                },
+                "position": {
+                  "enum": [
+                    "within",
+                    "after",
+                    "title"
+                  ],
+                  "type": "string"
+                }
+              },
+              "required": [
+                "celex",
+                "marker",
+                "form",
+                "position",
+                "act",
+                "instrument_id"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "EUR-Lex deletion stubs on the whole provision, in source order, each with the act that deleted what stood there. \"within\": the nth \"—————\" in the provision text; \"after\": something deleted after this provision (a whole article or chapter); \"title\": in its heading. Mechanically derived from the stub's own EUR-Lex pointer; not part of the legal text. Null means the release predates the record (see the typed warning), never that nothing was deleted."
+      },
+      "instrument_id": {
+        "type": "string"
+      },
+      "kind": {
+        "type": "string"
+      },
+      "markdown": {
+        "type": "string"
+      },
+      "narrowed": {
+        "type": "boolean"
+      },
+      "source_notes": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "complete": {
+                "const": true,
+                "description": "All notes referenced in this response's text, not the whole document or later pages.",
+                "type": "boolean"
+              },
+              "items": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "marker": {
+                      "type": "string"
+                    },
+                    "text": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key",
+                    "marker",
+                    "text"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "scope": {
+                "const": "returned_text",
+                "type": "string"
+              },
+              "source_version_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "scope",
+              "source_version_id",
+              "complete",
+              "items"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
+      },
+      "url": {
+        "type": "string"
+      },
+      "version_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "instrument_id",
+      "version_id",
+      "cite",
+      "kind",
+      "markdown",
+      "source_notes",
+      "deletions",
+      "narrowed",
+      "blocks_in_page",
+      "blocks_total",
+      "blocks_in_provision",
+      "content_hash",
+      "url"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed21 schema fields changedOct 4, 2026

addedInput schema / properties / cursor / anyOf

Added value: +[
+  {
+    "maxLength": 512,
+    "pattern": "^[A-Za-z0-9_-]+$",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / cursor / type
```
Removed value: -[
-  "string",
-  "null"
-]
```
addedInput schema / properties / instrument_id / maxLength
```
Added value: +64
```
addedInput schema / properties / instrument_id / pattern
```
Added value: +"^[a-z0-9]+(?:-[a-z0-9]+)*$"
```

addedInput schema / properties / locator / properties / annex / anyOf

Added value: +[
+  {
+    "maxLength": 32,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / locator / properties / annex / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

addedInput schema / properties / locator / properties / article / anyOf

Added value: +[
+  {
+    "maxLength": 32,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / locator / properties / article / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

addedInput schema / properties / locator / properties / paragraph / anyOf

Added value: +[
+  {
+    "maxLength": 32,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / locator / properties / paragraph / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

addedInput schema / properties / locator / properties / point / anyOf

Added value: +[
+  {
+    "maxLength": 32,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / locator / properties / point / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

addedInput schema / properties / locator / properties / recital / anyOf

Added value: +[
+  {
+    "maxLength": 32,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / locator / properties / recital / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

addedInput schema / properties / locator / properties / subpoint / anyOf

Added value: +[
+  {
+    "maxLength": 32,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / locator / properties / subpoint / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

addedInput schema / properties / on_date / anyOf

Added value: +[
+  {
+    "maxLength": 32,
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / on_date / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

addedInput schema / properties / version_id / anyOf

Added value: +[
+  {
+    "maxLength": 64,
+    "pattern": "^[A-Za-z0-9]+(?:-[A-Za-z0-9]+)*$",
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / version_id / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

changedOutput schema / properties / data / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "blocks_in_page": {
-        "type": "number"
-      },
-      "blocks_in_provision": {
-        "type": "number"
-      },
-      "blocks_total": {
-        "type": "number"
-      },
-      "cite": {
-        "type": "string"
-      },
-      "content_hash": {
-        "type": "string"
-      },
-      "correspondences": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "derivation": {
-                  "type": "string"
-                },
-                "note": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "relationship": {
-                  "type": "string"
-                },
-                "target": {
-                  "additionalProperties": {},
-                  "properties": {
-                    "cite": {
-                      "type": "string"
-                    },
-                    "instrument_id": {
-                      "type": "string"
-                    },
-                    "locator": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "annex": {
-                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered.",
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "article": {
-                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\".",
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "kind": {
-                          "description": "Which kind of provision the locator names.",
-                          "enum": [
-                            "article",
-                            "annex",
-                            "recital"
-                          ],
-                          "type": "string"
-                        },
-                        "paragraph": {
-                          "description": "Numbered paragraph within the article, e.g. \"2\".",
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "point": {
-                          "description": "Lettered point within the paragraph, e.g. \"b\".",
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "recital": {
-                          "description": "Recital number, e.g. \"95\".",
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "subpoint": {
-                          "description": "Sub-point within the point.",
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        }
-                      },
-                      "required": [
-                        "kind"
-                      ],
-                      "type": "object"
-                    },
-                    "url": {
-                      "type": "string"
-                    },
-                    "version_id": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "instrument_id",
-                    "version_id",
-                    "cite",
-                    "url",
-                    "locator"
-                  ],
-                  "type": "object"
-                }
-              },
-              "required": [
-                "relationship",
-                "derivation",
-                "note",
-                "target"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "instrument_id": {
-        "type": "string"
-      },
-      "kind": {
-        "type": "string"
-      },
-      "markdown": {
-        "type": "string"
-      },
-      "narrowed": {
-        "type": "boolean"
-      },
-      "source_notes": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "complete": {
-                "const": true,
-                "description": "All notes referenced in this response's text, not the whole document or later pages.",
-                "type": "boolean"
-              },
-              "items": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "marker": {
-                      "type": "string"
-                    },
-                    "text": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key",
-                    "marker",
-                    "text"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "scope": {
-                "const": "returned_text",
-                "type": "string"
-              },
-              "source_version_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "scope",
-              "source_version_id",
-              "complete",
-              "items"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
-      },
-      "url": {
-        "type": "string"
-      },
-      "version_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "instrument_id",
-      "version_id",
-      "cite",
-      "kind",
-      "markdown",
-      "source_notes",
-      "narrowed",
-      "blocks_in_page",
-      "blocks_total",
-      "blocks_in_provision",
-      "content_hash",
-      "url"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "blocks_in_page": {
+        "type": "number"
+      },
+      "blocks_in_provision": {
+        "type": "number"
+      },
+      "blocks_total": {
+        "type": "number"
+      },
+      "cite": {
+        "type": "string"
+      },
+      "content_hash": {
+        "type": "string"
+      },
+      "correspondences": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "derivation": {
+                  "type": "string"
+                },
+                "note": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "relationship": {
+                  "type": "string"
+                },
+                "target": {
+                  "additionalProperties": {},
+                  "properties": {
+                    "cite": {
+                      "type": "string"
+                    },
+                    "instrument_id": {
+                      "type": "string"
+                    },
+                    "locator": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "annex": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered."
+                        },
+                        "article": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\"."
+                        },
+                        "kind": {
+                          "description": "Which kind of provision the locator names.",
+                          "enum": [
+                            "article",
+                            "annex",
+                            "recital"
+                          ],
+                          "type": "string"
+                        },
+                        "paragraph": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Numbered paragraph within the article, e.g. \"2\"."
+                        },
+                        "point": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Lettered point within the paragraph, e.g. \"b\"."
+                        },
+                        "recital": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Recital number, e.g. \"95\"."
+                        },
+                        "subpoint": {
+                          "anyOf": [
+                            {
+                              "maxLength": 32,
+                              "type": "string"
+                            },
+                            {
+                              "type": "null"
+                            }
+                          ],
+                          "description": "Sub-point within the point."
+                        }
+                      },
+                      "required": [
+                        "kind"
+                      ],
+                      "type": "object"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "version_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "instrument_id",
+                    "version_id",
+                    "cite",
+                    "url",
+                    "locator"
+                  ],
+                  "type": "object"
+                }
+              },
+              "required": [
+                "relationship",
+                "derivation",
+                "note",
+                "target"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "instrument_id": {
+        "type": "string"
+      },
+      "kind": {
+        "type": "string"
+      },
+      "markdown": {
+        "type": "string"
+      },
+      "narrowed": {
+        "type": "boolean"
+      },
+      "source_notes": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "complete": {
+                "const": true,
+                "description": "All notes referenced in this response's text, not the whole document or later pages.",
+                "type": "boolean"
+              },
+              "items": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "marker": {
+                      "type": "string"
+                    },
+                    "text": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key",
+                    "marker",
+                    "text"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "scope": {
+                "const": "returned_text",
+                "type": "string"
+              },
+              "source_version_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "scope",
+              "source_version_id",
+              "complete",
+              "items"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
+      },
+      "url": {
+        "type": "string"
+      },
+      "version_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "instrument_id",
+      "version_id",
+      "cite",
+      "kind",
+      "markdown",
+      "source_notes",
+      "narrowed",
+      "blocks_in_page",
+      "blocks_total",
+      "blocks_in_provision",
+      "content_hash",
+      "url"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed22 schema fields changedSep 20, 2026

removedInput schema / properties / cursor / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / cursor / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / include_correspondences / anyOf

Removed value: -[
-  {
-    "type": "boolean"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / include_correspondences / type
```
Added value: +[
+  "boolean",
+  "null"
+]
```

removedInput schema / properties / locator / properties / annex / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / annex / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / article / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / article / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / paragraph / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / paragraph / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / point / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / point / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / recital / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / recital / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / locator / properties / subpoint / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / locator / properties / subpoint / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / on_date / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / on_date / type
```
Added value: +[
+  "string",
+  "null"
+]
```

removedInput schema / properties / version_id / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / version_id / type
```
Added value: +[
+  "string",
+  "null"
+]
```

changedOutput schema / properties / data / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "blocks_in_page": {
-        "type": "number"
-      },
-      "blocks_in_provision": {
-        "type": "number"
-      },
-      "blocks_total": {
-        "type": "number"
-      },
-      "cite": {
-        "type": "string"
-      },
-      "content_hash": {
-        "type": "string"
-      },
-      "correspondences": {
-        "anyOf": [
-          {
-            "items": {
-              "additionalProperties": {},
-              "properties": {
-                "derivation": {
-                  "type": "string"
-                },
-                "note": {
-                  "anyOf": [
-                    {
-                      "type": "string"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                },
-                "relationship": {
-                  "type": "string"
-                },
-                "target": {
-                  "additionalProperties": {},
-                  "properties": {
-                    "cite": {
-                      "type": "string"
-                    },
-                    "instrument_id": {
-                      "type": "string"
-                    },
-                    "locator": {
-                      "additionalProperties": false,
-                      "properties": {
-                        "annex": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered."
-                        },
-                        "article": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\"."
-                        },
-                        "kind": {
-                          "description": "Which kind of provision the locator names.",
-                          "enum": [
-                            "article",
-                            "annex",
-                            "recital"
-                          ],
-                          "type": "string"
-                        },
-                        "paragraph": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Numbered paragraph within the article, e.g. \"2\"."
-                        },
-                        "point": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Lettered point within the paragraph, e.g. \"b\"."
-                        },
-                        "recital": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Recital number, e.g. \"95\"."
-                        },
-                        "subpoint": {
-                          "anyOf": [
-                            {
-                              "type": "string"
-                            },
-                            {
-                              "type": "null"
-                            }
-                          ],
-                          "description": "Sub-point within the point."
-                        }
-                      },
-                      "required": [
-                        "kind"
-                      ],
-                      "type": "object"
-                    },
-                    "url": {
-                      "type": "string"
-                    },
-                    "version_id": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "instrument_id",
-                    "version_id",
-                    "cite",
-                    "url",
-                    "locator"
-                  ],
-                  "type": "object"
-                }
-              },
-              "required": [
-                "relationship",
-                "derivation",
-                "note",
-                "target"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "instrument_id": {
-        "type": "string"
-      },
-      "kind": {
-        "type": "string"
-      },
-      "markdown": {
-        "type": "string"
-      },
-      "narrowed": {
-        "type": "boolean"
-      },
-      "source_notes": {
-        "anyOf": [
-          {
-            "additionalProperties": false,
-            "properties": {
-              "complete": {
-                "const": true,
-                "description": "All notes referenced in this response's text, not the whole document or later pages.",
-                "type": "boolean"
-              },
-              "items": {
-                "items": {
-                  "additionalProperties": false,
-                  "properties": {
-                    "key": {
-                      "type": "string"
-                    },
-                    "marker": {
-                      "type": "string"
-                    },
-                    "text": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "key",
-                    "marker",
-                    "text"
-                  ],
-                  "type": "object"
-                },
-                "type": "array"
-              },
-              "scope": {
-                "const": "returned_text",
-                "type": "string"
-              },
-              "source_version_id": {
-                "type": "string"
-              }
-            },
-            "required": [
-              "scope",
-              "source_version_id",
-              "complete",
-              "items"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
-      },
-      "url": {
-        "type": "string"
-      },
-      "version_id": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "instrument_id",
-      "version_id",
-      "cite",
-      "kind",
-      "markdown",
-      "source_notes",
-      "narrowed",
-      "blocks_in_page",
-      "blocks_total",
-      "blocks_in_provision",
-      "content_hash",
-      "url"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "blocks_in_page": {
+        "type": "number"
+      },
+      "blocks_in_provision": {
+        "type": "number"
+      },
+      "blocks_total": {
+        "type": "number"
+      },
+      "cite": {
+        "type": "string"
+      },
+      "content_hash": {
+        "type": "string"
+      },
+      "correspondences": {
+        "anyOf": [
+          {
+            "items": {
+              "additionalProperties": {},
+              "properties": {
+                "derivation": {
+                  "type": "string"
+                },
+                "note": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "relationship": {
+                  "type": "string"
+                },
+                "target": {
+                  "additionalProperties": {},
+                  "properties": {
+                    "cite": {
+                      "type": "string"
+                    },
+                    "instrument_id": {
+                      "type": "string"
+                    },
+                    "locator": {
+                      "additionalProperties": false,
+                      "properties": {
+                        "annex": {
+                          "description": "Annex number, roman or arabic (\"I\", \"1\"); omit for an instrument whose single annex is unnumbered.",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "article": {
+                          "description": "Article number as printed: \"97\", \"45a\", \"69-a\".",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "kind": {
+                          "description": "Which kind of provision the locator names.",
+                          "enum": [
+                            "article",
+                            "annex",
+                            "recital"
+                          ],
+                          "type": "string"
+                        },
+                        "paragraph": {
+                          "description": "Numbered paragraph within the article, e.g. \"2\".",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "point": {
+                          "description": "Lettered point within the paragraph, e.g. \"b\".",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "recital": {
+                          "description": "Recital number, e.g. \"95\".",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "subpoint": {
+                          "description": "Sub-point within the point.",
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "kind"
+                      ],
+                      "type": "object"
+                    },
+                    "url": {
+                      "type": "string"
+                    },
+                    "version_id": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "instrument_id",
+                    "version_id",
+                    "cite",
+                    "url",
+                    "locator"
+                  ],
+                  "type": "object"
+                }
+              },
+              "required": [
+                "relationship",
+                "derivation",
+                "note",
+                "target"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          {
+            "type": "null"
+          }
+        ]
+      },
+      "instrument_id": {
+        "type": "string"
+      },
+      "kind": {
+        "type": "string"
+      },
+      "markdown": {
+        "type": "string"
+      },
+      "narrowed": {
+        "type": "boolean"
+      },
+      "source_notes": {
+        "anyOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "complete": {
+                "const": true,
+                "description": "All notes referenced in this response's text, not the whole document or later pages.",
+                "type": "boolean"
+              },
+              "items": {
+                "items": {
+                  "additionalProperties": false,
+                  "properties": {
+                    "key": {
+                      "type": "string"
+                    },
+                    "marker": {
+                      "type": "string"
+                    },
+                    "text": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "key",
+                    "marker",
+                    "text"
+                  ],
+                  "type": "object"
+                },
+                "type": "array"
+              },
+              "scope": {
+                "const": "returned_text",
+                "type": "string"
+              },
+              "source_version_id": {
+                "type": "string"
+              }
+            },
+            "required": [
+              "scope",
+              "source_version_id",
+              "complete",
+              "items"
+            ],
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "Null means unverified/unsupported coverage or an older release; consult the typed warning. Not an empty note inventory. Legal content_hash and block counts exclude this attachment."
+      },
+      "url": {
+        "type": "string"
+      },
+      "version_id": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "instrument_id",
+      "version_id",
+      "cite",
+      "kind",
+      "markdown",
+      "source_notes",
+      "narrowed",
+      "blocks_in_page",
+      "blocks_total",
+      "blocks_in_provision",
+      "content_hash",
+      "url"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / properties / pagination / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "complete": {
-        "type": "boolean"
-      },
-      "next_cursor": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ]
-      },
-      "total": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "complete",
-      "next_cursor"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "complete": {
+        "type": "boolean"
+      },
+      "next_cursor": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "total": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "complete",
+      "next_cursor"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

First observedSep 6, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations only cover the safe-read profile; the description goes well beyond by disclosing pagination by structural block with no silent truncation, the version_id refusal path and the URL returned, correspondence vocabulary and inverse relationships, and the correspondence_withheld warning behavior. This is unusually rich disclosure of edge cases an agent must anticipate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with purpose and output format, and every sentence carries information. Some sentences are dense and comma-heavy (the correspondence paragraphs), but nothing is filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a nested-locator, paginated, version-aware read tool with an output schema present, the definition covers output format, pagination, version handling and the optional correspondence expansion. An agent could call this correctly without further inquiry.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 83%, so the schema already documents most fields; the description nonetheless adds real meaning for the two non-obvious ones — version_id's optional/'current' semantics and refusal behavior, and include_correspondences' null-vs-empty distinction and warning semantics. It adds little for cursor or the locator subfields, which are schema-covered.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource (read/quote an EU legislative provision) with concrete examples (PSD2 Article 97, RTS-SCA Article 5), making it easily distinguishable from siblings like list_provisions or resolve_citation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives clear context for invocation — reading or quoting an article, annex or recital, plus the guidance to use a second call to open a correspondence locator. It stops short of naming the competing siblings (e.g. list_provisions, resolve_citation) or stating when not to use it, so it is clear but not fully routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All Payments Law — EU payments legislation tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?