Previous value: -"True when LEI candidates remain beyond this page — re-call with nextOffset."New value: +"True when the result set holds candidates beyond this page — re-call with nextOffset. It describes pages only: false on the last page, whatever totalAvailableBasis says."

Previous value: -"Guidance when no LEI matched and how to broaden, when the requested offset sits past the end of the result set, or when the mirror has not indexed GLEIF's other and transliterated names yet, so only legal names were searched."New value: +"Guidance when no LEI matched and how to broaden, when the requested offset sits past the end of the result set, when a bound cut the candidate set and how to narrow the name, or when the mirror has not indexed GLEIF's other and transliterated names yet, so only legal names were searched."

Previous value: -"LEI candidates available across all pages, before limit and offset were applied."New value: +"LEI candidates in the result set across all pages, before limit and offset were applied — every one is reachable by paging."

Previous value: -"How to read totalAvailable: exact = the complete strict candidate set; lower_bound = a bounded scan produced it (every fuzzy pass, and any strict pass that hit the raw-row scan cap), so more may exist."New value: +"How to read totalAvailable: exact = the complete strict candidate set; lower_bound = a fuzzy pass ran, which scores only the candidates blocking pooled, or the strict scan stopped at its 2,000-name bound, so more candidates may exist beyond the result set."

Previous value: -[
-  {
-    "const": "",
-    "type": "string"
-  },
-  {
-    "description": "ISO 3166-1 alpha-2 jurisdiction code (e.g. US, GB).",
-    "pattern": "^[A-Za-z]{2}$",
-    "type": "string"
-  }
-]New value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "ISO 3166-1 alpha-2 country code (e.g. US) or ISO 3166-2 subdivision code (e.g. US-DE), case-insensitive.",
+    "pattern": "^[A-Za-z]{2}(-[A-Za-z0-9]{1,3})?$",
+    "type": "string"
+  }
+]

Previous value: -"Optional ISO 3166-1 alpha-2 jurisdiction filter (e.g. \"US\", \"GB\"). Empty string disables it."New value: +"Optional legal-jurisdiction filter. A country code (\"US\") matches that country and every subdivision under it (US-DE, US-CA); a subdivision code (\"US-DE\") matches exactly. Case-insensitive. Empty string disables it."

Previous value: -"Registration status filter: issued (default), lapsed, or any."New value: +"Registration status filter. issued (default) matches ISSUED; lapsed matches exactly LAPSED; any applies no filter and is the only value that reaches the other states (RETIRED, DUPLICATE, ANNULLED, PENDING_TRANSFER, PENDING_ARCHIVAL, MERGED) — each candidate's status field names its state."

Previous value: -"The name (legal or other/trading) that matched the query."New value: +"The name that matched the query — the legal name or one of the other or transliterated names GLEIF publishes for the entity."

Added value: +{
+  "description": "Type of matchedName: LEGAL_NAME, PREVIOUS_LEGAL_NAME (a former legal name, not the current one), TRADING_OR_OPERATING_NAME, ALTERNATIVE_LANGUAGE_LEGAL_NAME, PREFERRED_ASCII_TRANSLITERATED_LEGAL_NAME, AUTO_ASCII_TRANSLITERATED_LEGAL_NAME, or UNKNOWN for a name the mirror stored without GLEIF's type.",
+  "type": "string"
+}

Previous value: -[
-  "lei",
-  "legalName",
-  "matchedName",
-  "matchType"
-]New value: +[
+  "lei",
+  "legalName",
+  "matchedName",
+  "matchedNameType",
+  "matchType"
+]

Previous value: -"Guidance when no LEI matched and how to broaden, or when the requested offset sits past the end of the result set."New value: +"Guidance when no LEI matched and how to broaden, when the requested offset sits past the end of the result set, or when the mirror has not indexed GLEIF's other and transliterated names yet, so only legal names were searched."

Previous value: -"The company / organization name to resolve to an LEI."New value: +"The company / organization name to resolve to an LEI, in any script. It must contain at least one letter or digit, and at most 64 words and 1024 characters."

Previous value: -"Machine-readable failure mode. Declared by this tool: `mirror_not_ready`: The GLEIF (LEI) mirror has never completed an initial sync. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `name_not_searchable`: The name contains no letter or digit, so nothing in it can be matched. `name_too_long`: The name is longer than 64 words or 1024 characters. `mirror_not_ready`: The GLEIF (LEI) mirror has never completed an initial sync. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "mirror_not_ready"
-]New value: +[
+  "name_not_searchable",
+  "name_too_long",
+  "mirror_not_ready"
+]

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

Added value: +false

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

Added value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "matches",
+      "normalizedQuery",
+      "matchModeUsed",
+      "totalCount",
+      "totalAvailable",
+      "totalAvailableBasis",
+      "hasMore"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "additionalProperties": {},
+  "description": "Present when the call failed. Absent on success.",
+  "properties": {
+    "code": {
+      "description": "JSON-RPC error code for this failure.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "data": {
+      "additionalProperties": {},
+      "properties": {
+        "reason": {
+          "description": "Machine-readable failure mode. Declared by this tool: `mirror_not_ready`: The GLEIF (LEI) mirror has never completed an initial sync. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "mirror_not_ready"
+          ],
+          "type": "string"
+        },
+        "recovery": {
+          "additionalProperties": {},
+          "description": "Actionable next step for the caller.",
+          "properties": {
+            "hint": {
+              "type": "string"
+            }
+          },
+          "required": [
+            "hint"
+          ],
+          "type": "object"
+        },
+        "retryable": {
+          "description": "Whether retrying may succeed.",
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "message": {
+      "description": "Human-readable description of what went wrong.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "code",
+    "message"
+  ],
+  "type": "object"
+}

Removed value: -[
-  "matches",
-  "normalizedQuery",
-  "matchModeUsed",
-  "totalCount",
-  "totalAvailable",
-  "totalAvailableBasis",
-  "hasMore"
-]

Previous value: -"Maximum LEI candidates to return."New value: +"Maximum LEI candidates to return in one page."

Added value: +{
+  "default": 0,
+  "description": "Zero-based index of the first LEI candidate to return. Re-call with the returned nextOffset to page through every candidate when hasMore is true; an offset past the end returns an empty page, not an error.",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

Added value: +{
+  "description": "True when LEI candidates remain beyond this page — re-call with nextOffset.",
+  "type": "boolean"
+}

Previous value: -"Ranked LEI candidates, highest-confidence first."New value: +"LEI candidates, ranked by match type, then score, then how much of the query each matched name explains."

Added value: +{
+  "additionalProperties": false,
+  "description": "How much of the query the matched name explains, as a literal token count — a second real measurement, never folded into score. It is the tie-break applied after score, because one shared exact token pins several candidates at the same score. Absent for exact/strong matches.",
+  "properties": {
+    "covered": {
+      "description": "Query tokens individually matched by one of the matched name's tokens at the applied score floor.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    },
+    "total": {
+      "description": "Total tokens in the normalized query.",
+      "maximum": 9007199254740991,
+      "minimum": -9007199254740991,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "covered",
+    "total"
+  ],
+  "type": "object"
+}

Added value: +{
+  "description": "The offset to request next. Present only when hasMore is true.",
+  "type": "number"
+}

Previous value: -"Guidance when no LEI matched and how to broaden."New value: +"Guidance when no LEI matched and how to broaden, or when the requested offset sits past the end of the result set."

Added value: +{
+  "description": "LEI candidates available across all pages, before limit and offset were applied.",
+  "type": "number"
+}

Added value: +{
+  "description": "How to read totalAvailable: exact = the complete strict candidate set; lower_bound = a bounded scan produced it (every fuzzy pass, and any strict pass that hit the raw-row scan cap), so more may exist.",
+  "enum": [
+    "exact",
+    "lower_bound"
+  ],
+  "type": "string"
+}

Previous value: -"Number of LEI candidates returned."New value: +"Number of LEI candidates returned in this page."

Previous value: -[
-  "matches",
-  "normalizedQuery",
-  "matchModeUsed",
-  "totalCount"
-]New value: +[
+  "matches",
+  "normalizedQuery",
+  "matchModeUsed",
+  "totalCount",
+  "totalAvailable",
+  "totalAvailableBasis",
+  "hasMore"
+]