Skip to main content
Glama

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, with its cite anchor, provenance and text state; a long provision paginates by structural block. version_id is optional, and a pinned version id is refused with the URL where that text is published. include_correspondences adds the cross-instrument article equivalences.

Input Schema

NameRequiredDescriptionDefault
cursorNoContinue a paginated provision. Bound to the release.
locatorYes
on_dateNoISO date; returns the provision-level applicability view.
version_idNoOmit, or pass "current", for the served text. A pinned version id returns version_not_served with the URL where that text is published.
instrument_idYesRegistry id of the instrument, e.g. "psd-2".
include_correspondencesNoOff by default. When true, an article carries correspondences[]: the cross-instrument article equivalences the corpus publishes, each with the counterpart's own get_provision locator, version and cite anchor. null means the release predates the mapping table, not that the article has none.

Output Schema

NameRequiredDescriptionDefault
dataYes
errorYes
coverageYes
warningsYes
paginationYes
provenanceYes
derivationsYes
corpus_releaseYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / include_correspondences / description
      Previous value: -"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 recorded on the article; where the correlation table is paragraph-specific and the pairing is verified by wording, an entry carries `paragraph_pairs`. A request narrowed to a paragraph or a point still receives the whole article's mappings, and a warning says whether any entry is paragraph-level. `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."New value: +"Off by default. When true, an article carries correspondences[]: the cross-instrument article equivalences the corpus publishes, each with the counterpart's own get_provision locator, version and cite anchor. null means the release predates the mapping table, not that the article has none."
    • 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"
      -                  ]
      -                },
      -                "paragraph_pairs": {
      -                  "description": "A paragraph-specific mapping's verified rows, as {predecessor, successor} provision labels (\"5(3)\", \"36(4)\"); absent where the mapping is article to article; a side without a paragraph number is a printed pairing that fell back to its article.",
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "predecessor": {
      -                        "type": "string"
      -                      },
      -                      "successor": {
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "predecessor",
      -                      "successor"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "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": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "follows": {
      -                      "type": "string"
      -                    },
      -                    "follows_part": {
      -                      "description": "The bar follows the closing subparagraph of the paragraph in `follows`.",
      -                      "enum": [
      -                        "closing_subparagraph"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "form": {
      -                      "const": "block",
      -                      "type": "string"
      -                    },
      -                    "heading": {
      -                      "type": "string"
      -                    },
      -                    "marker": {
      -                      "const": "▌",
      -                      "type": "string"
      -                    },
      -                    "page": {
      -                      "exclusiveMinimum": 0,
      -                      "maximum": 9007199254740991,
      -                      "type": "integer"
      -                    },
      -                    "position": {
      -                      "enum": [
      -                        "within",
      -                        "after"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "precedes": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "precedes_part": {
      -                      "description": "The bar precedes the closing subparagraph of the paragraph in `precedes`.",
      -                      "enum": [
      -                        "closing_subparagraph"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "source": {
      -                      "const": "council_compromise",
      -                      "type": "string"
      -                    },
      -                    "source_doc": {
      -                      "type": "string"
      -                    },
      -                    "source_url": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "source",
      -                    "marker",
      -                    "form",
      -                    "position",
      -                    "follows",
      -                    "precedes",
      -                    "source_doc",
      -                    "page",
      -                    "source_url"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "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": "Deletions marked on the whole provision, in source order. A EUR-Lex deletion stub names 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. A record with source \"council_compromise\" is a ▌ the Council compromise text prints on a line of its own where it deleted a point, paragraph or passage: `follows` and `precedes` name the items it stands between (\"after\": at the end of the provision text, precedes null, with `heading` as for a stub), `follows_part` or `precedes_part` says that side is the paragraph's closing subparagraph; `page` and `source_url` give the page of the Council document that prints it; the provision text carries no mark for it. The record says where the bar stands, not what was removed, and compare_versions does not show it. Mechanically derived from the source; not part of the legal text. Null means no record is served for this provision (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"
      +                  ]
      +                },
      +                "paragraph_pairs": {
      +                  "description": "A paragraph-specific mapping's verified rows, as {predecessor, successor} provision labels (\"5(3)\", \"36(4)\"); absent where the mapping is article to article; a side without a paragraph number is a printed pairing that fell back to its article. Correspondences are recorded on the article; where the correlation table is paragraph-specific and the pairing is verified by wording, an entry carries `paragraph_pairs`. A request narrowed to a paragraph or a point still receives the whole article's mappings, and a warning says whether any entry is paragraph-level.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "predecessor": {
      +                        "type": "string"
      +                      },
      +                      "successor": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "predecessor",
      +                      "successor"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "relationship": {
      +                  "description": "amended_from or supersedes, the analysis layer's own vocabulary, or their mechanical inverses amended_into and superseded_by.",
      +                  "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"
      +          }
      +        ],
      +        "description": "An annex or a recital carries an empty list. A mapping this service will not serve is omitted and correspondence_withheld names the instrument and the reason, so a short list is never silently under-claimed."
      +      },
      +      "deletions": {
      +        "anyOf": [
      +          {
      +            "items": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "follows": {
      +                      "type": "string"
      +                    },
      +                    "follows_part": {
      +                      "description": "The bar follows the closing subparagraph of the paragraph in `follows`.",
      +                      "enum": [
      +                        "closing_subparagraph"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "form": {
      +                      "const": "block",
      +                      "type": "string"
      +                    },
      +                    "heading": {
      +                      "type": "string"
      +                    },
      +                    "marker": {
      +                      "const": "▌",
      +                      "type": "string"
      +                    },
      +                    "page": {
      +                      "exclusiveMinimum": 0,
      +                      "maximum": 9007199254740991,
      +                      "type": "integer"
      +                    },
      +                    "position": {
      +                      "enum": [
      +                        "within",
      +                        "after"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "precedes": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "precedes_part": {
      +                      "description": "The bar precedes the closing subparagraph of the paragraph in `precedes`.",
      +                      "enum": [
      +                        "closing_subparagraph"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "source": {
      +                      "const": "council_compromise",
      +                      "type": "string"
      +                    },
      +                    "source_doc": {
      +                      "type": "string"
      +                    },
      +                    "source_url": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "source",
      +                    "marker",
      +                    "form",
      +                    "position",
      +                    "follows",
      +                    "precedes",
      +                    "source_doc",
      +                    "page",
      +                    "source_url"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "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": "Deletions marked on the whole provision, in source order. A EUR-Lex deletion stub names 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. A record with source \"council_compromise\" is a ▌ the Council compromise text prints on a line of its own where it deleted a point, paragraph or passage: `follows` and `precedes` name the items it stands between (\"after\": at the end of the provision text, precedes null, with `heading` as for a stub), `follows_part` or `precedes_part` says that side is the paragraph's closing subparagraph; `page` and `source_url` give the page of the Council document that prints it; the provision text carries no mark for it. The record says where the bar stands, not what was removed, and compare_versions does not show it. Mechanically derived from the source; not part of the legal text. Null means no record is served for this provision (see the typed warning), never that nothing was deleted."
      +      },
      +      "instrument_id": {
      +        "type": "string"
      +      },
      +      "kind": {
      +        "type": "string"
      +      },
      +      "markdown": {
      +        "description": "The provision's source text as markdown. A sub- or superscript with no Unicode form is inline <sub>/<sup> (K<sub>IRB</sub>); one with a Unicode form uses it (m²).",
      +        "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. The verified note scope is DMD articles and recitals. Introductory citations are not an MCP provision kind: their notes remain on the website and exports, not attached to articles."
      +      },
      +      "title": {
      +        "description": "Plain text: a script with a Unicode form uses it, one without reads flat (KCCP).",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "title_path": {
      +        "description": "Plain text: a script with a Unicode form uses it, one without reads flat (KCCP).",
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "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"
      +  }
      +]
  2. Changed1 schema field changed
    • 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"
      -                  ]
      -                },
      -                "paragraph_pairs": {
      -                  "description": "A paragraph-specific mapping's verified rows, as {predecessor, successor} provision labels (\"5(3)\", \"36(4)\"); absent where the mapping is article to article; a side without a paragraph number is a printed pairing that fell back to its article.",
      -                  "items": {
      -                    "additionalProperties": false,
      -                    "properties": {
      -                      "predecessor": {
      -                        "type": "string"
      -                      },
      -                      "successor": {
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "predecessor",
      -                      "successor"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "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": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "follows": {
      -                      "type": "string"
      -                    },
      -                    "form": {
      -                      "const": "block",
      -                      "type": "string"
      -                    },
      -                    "marker": {
      -                      "const": "▌",
      -                      "type": "string"
      -                    },
      -                    "page": {
      -                      "exclusiveMinimum": 0,
      -                      "maximum": 9007199254740991,
      -                      "type": "integer"
      -                    },
      -                    "position": {
      -                      "enum": [
      -                        "within",
      -                        "after"
      -                      ],
      -                      "type": "string"
      -                    },
      -                    "precedes": {
      -                      "type": [
      -                        "string",
      -                        "null"
      -                      ]
      -                    },
      -                    "source": {
      -                      "const": "council_compromise",
      -                      "type": "string"
      -                    },
      -                    "source_doc": {
      -                      "type": "string"
      -                    },
      -                    "source_url": {
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "source",
      -                    "marker",
      -                    "form",
      -                    "position",
      -                    "follows",
      -                    "precedes",
      -                    "source_doc",
      -                    "page",
      -                    "source_url"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "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": "Deletions marked on the whole provision, in source order. A EUR-Lex deletion stub names 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. A record with source \"council_compromise\" is a ▌ the Council compromise text prints on a line of its own where it deleted a point, paragraph or passage: `follows` and `precedes` name the items it stands between (\"after\": at the end of the provision text, precedes null), and `page` and `source_url` the page of the Council document that prints it; the provision text carries no mark for it, and the Council prints no number for what it deleted. Mechanically derived from the source; 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"
      +                  ]
      +                },
      +                "paragraph_pairs": {
      +                  "description": "A paragraph-specific mapping's verified rows, as {predecessor, successor} provision labels (\"5(3)\", \"36(4)\"); absent where the mapping is article to article; a side without a paragraph number is a printed pairing that fell back to its article.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "predecessor": {
      +                        "type": "string"
      +                      },
      +                      "successor": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "predecessor",
      +                      "successor"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "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": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "follows": {
      +                      "type": "string"
      +                    },
      +                    "follows_part": {
      +                      "description": "The bar follows the closing subparagraph of the paragraph in `follows`.",
      +                      "enum": [
      +                        "closing_subparagraph"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "form": {
      +                      "const": "block",
      +                      "type": "string"
      +                    },
      +                    "heading": {
      +                      "type": "string"
      +                    },
      +                    "marker": {
      +                      "const": "▌",
      +                      "type": "string"
      +                    },
      +                    "page": {
      +                      "exclusiveMinimum": 0,
      +                      "maximum": 9007199254740991,
      +                      "type": "integer"
      +                    },
      +                    "position": {
      +                      "enum": [
      +                        "within",
      +                        "after"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "precedes": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "precedes_part": {
      +                      "description": "The bar precedes the closing subparagraph of the paragraph in `precedes`.",
      +                      "enum": [
      +                        "closing_subparagraph"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "source": {
      +                      "const": "council_compromise",
      +                      "type": "string"
      +                    },
      +                    "source_doc": {
      +                      "type": "string"
      +                    },
      +                    "source_url": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "source",
      +                    "marker",
      +                    "form",
      +                    "position",
      +                    "follows",
      +                    "precedes",
      +                    "source_doc",
      +                    "page",
      +                    "source_url"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "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": "Deletions marked on the whole provision, in source order. A EUR-Lex deletion stub names 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. A record with source \"council_compromise\" is a ▌ the Council compromise text prints on a line of its own where it deleted a point, paragraph or passage: `follows` and `precedes` name the items it stands between (\"after\": at the end of the provision text, precedes null, with `heading` as for a stub), `follows_part` or `precedes_part` says that side is the paragraph's closing subparagraph; `page` and `source_url` give the page of the Council document that prints it; the provision text carries no mark for it. The record says where the bar stands, not what was removed, and compare_versions does not show it. Mechanically derived from the source; not part of the legal text. Null means no record is served for this provision (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"
      +  }
      +]
  3. Changed2 schema fields changed
    • changedInput schema / properties / include_correspondences / description
      Previous value: -"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."New value: +"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 recorded on the article; where the correlation table is paragraph-specific and the pairing is verified by wording, an entry carries `paragraph_pairs`. A request narrowed to a paragraph or a point still receives the whole article's mappings, and a warning says whether any entry is paragraph-level. `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."
    • 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"
      -                },
      -                "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"
      -  }
      -]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"
      +                  ]
      +                },
      +                "paragraph_pairs": {
      +                  "description": "A paragraph-specific mapping's verified rows, as {predecessor, successor} provision labels (\"5(3)\", \"36(4)\"); absent where the mapping is article to article; a side without a paragraph number is a printed pairing that fell back to its article.",
      +                  "items": {
      +                    "additionalProperties": false,
      +                    "properties": {
      +                      "predecessor": {
      +                        "type": "string"
      +                      },
      +                      "successor": {
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "predecessor",
      +                      "successor"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "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": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "follows": {
      +                      "type": "string"
      +                    },
      +                    "form": {
      +                      "const": "block",
      +                      "type": "string"
      +                    },
      +                    "marker": {
      +                      "const": "▌",
      +                      "type": "string"
      +                    },
      +                    "page": {
      +                      "exclusiveMinimum": 0,
      +                      "maximum": 9007199254740991,
      +                      "type": "integer"
      +                    },
      +                    "position": {
      +                      "enum": [
      +                        "within",
      +                        "after"
      +                      ],
      +                      "type": "string"
      +                    },
      +                    "precedes": {
      +                      "type": [
      +                        "string",
      +                        "null"
      +                      ]
      +                    },
      +                    "source": {
      +                      "const": "council_compromise",
      +                      "type": "string"
      +                    },
      +                    "source_doc": {
      +                      "type": "string"
      +                    },
      +                    "source_url": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "source",
      +                    "marker",
      +                    "form",
      +                    "position",
      +                    "follows",
      +                    "precedes",
      +                    "source_doc",
      +                    "page",
      +                    "source_url"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "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": "Deletions marked on the whole provision, in source order. A EUR-Lex deletion stub names 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. A record with source \"council_compromise\" is a ▌ the Council compromise text prints on a line of its own where it deleted a point, paragraph or passage: `follows` and `precedes` name the items it stands between (\"after\": at the end of the provision text, precedes null), and `page` and `source_url` the page of the Council document that prints it; the provision text carries no mark for it, and the Council prints no number for what it deleted. Mechanically derived from the source; 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"
      +  }
      +]
  4. Changed1 schema field changed
    • changedInput schema / properties / instrument_id / pattern
      Previous value: -"^[a-z0-9]+(?:-[a-z0-9]+)*$"New value: +"^[A-Za-z0-9]+(?:[ ._-][A-Za-z0-9]+)*$"
  5. Changed1 schema field changed
    • 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"
      +  }
      +]
  6. Changed1 schema field changed
    • 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"
      +  }
      +]
  7. Changed21 schema fields changed
    • 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"
      +  }
      +]
  8. Changed22 schema fields changed
    • 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"
      +  }
      +]
  9. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare readOnly, idempotent, non-destructive, so the description's job is added context — and it delivers: markdown source text with cite anchor, provenance and text state, block-level pagination for long provisions, and the specific refusal behavior for pinned version ids including the published URL. It stops short of describing cursor lifetime or error modes beyond version_not_served.

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 the purpose and examples, then layered behavior (return format, pagination, versioning, correspondences) in a single dense passage with no filler. Dense but every clause carries information; only the near-verbatim restatement of schema text is mild waste.

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

Completeness4/5

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

An output schema exists, so return values needn't be fully explained, and the description still sketches them plus pagination and version semantics. For a 6-parameter nested-locator read tool this is nearly sufficient; only cursor-driven continuation and how to obtain a cursor are left unaddressed.

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

Parameters3/5

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

Schema coverage is 83%, so the schema already carries most parameter meaning. The description largely restates it — 'version_id is optional, and a pinned version id is refused with the URL' mirrors the schema text for version_id, and the include_correspondences sentence duplicates that schema description. The locator-detail parameters (paragraph, point, subpoint) get no mention beyond the examples.

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 or quote an EU legislative provision') and anchors it with concrete examples (PSD2 Article 97, RTS-SCA Article 5) plus the returnable provision kinds (article, annex, recital). An agent can distinguish this from siblings like list_provisions, search_legislation or resolve_citation without opening the schema.

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

Usage Guidelines3/5

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

The 'read or quote' framing and the version_id/on_date notes imply when this tool is appropriate, but no sibling is named and no exclusion is stated. An agent must infer on its own that listing/enumeration belongs to list_provisions and citation resolution to resolve_citation.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources