Previous value: -"Machine-readable failure mode. Declared by this tool: `dataflow_not_found`: dataflow_id does not match any known dataflow on api.imf.org `dimension_not_found`: dimension_id does not match a dimension in the selected dataflow `structure_unavailable`: api.imf.org returns non-200 on the DSD endpoint `dataflow_list_unavailable`: The dataflow catalog that dataflow_id is resolved against could not be fetched — fires before the DSD lookup is attempted `availability_unavailable`: available_only is true and the dataflow-wide availability constraint cannot be fetched or parsed Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `dataflow_not_found`: dataflow_id does not match any known dataflow on api.imf.org. `dimension_not_found`: dimension_id does not match a dimension in the selected dataflow. `structure_unavailable`: api.imf.org returns non-200 on the DSD endpoint. `dataflow_list_unavailable`: The dataflow catalog that dataflow_id is resolved against could not be fetched — fires before the DSD lookup is attempted. `availability_unavailable`: available_only is true and the dataflow-wide availability constraint cannot be fetched or parsed. Other values are possible when a failure originates below the handler."

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

Added value: +[
+  "string",
+  "null"
+]

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

Added value: +[
+  "string",
+  "null"
+]

Added value: +{
+  "default": false,
+  "description": "Return only codes reported by the dataflow-wide availability constraint. Default false keeps ordinary codelist discovery unchanged.",
+  "type": "boolean"
+}

Added value: +{
+  "const": true,
+  "description": "True when dimensions contain published availability coverage rather than codelists.",
+  "type": "boolean"
+}

Previous value: -"A single dimension with its codelist."New value: +"A single dimension with its codelist or published availability coverage."

Added value: +{
+  "description": "Codes reported with published data before codelist_filter. Present when available_only is true.",
+  "type": "number"
+}

Previous value: -"Valid codes for this dimension. Unselected previews show up to 50 entries after optional filtering. Select dimension_id and use limit/offset for a bounded page of up to 200 entries. Empty means the filter matched nothing when codelist_filter is echoed back, and that the codelist could not be resolved when it is not — see notice."New value: +"Valid codelist codes for this dimension, or codes reported with published data when available_only is true. Unselected previews show up to 50 entries after optional filtering. Select dimension_id and use limit/offset for a bounded page of up to 200 entries. Empty means the filter matched nothing when codelist_filter is echoed back, no coverage was reported in availability mode, or the codelist could not be resolved in normal mode — see notice."

Previous value: -"Codes in the complete resolved codelist before codelist_filter is applied."New value: +"Source codes before codelist_filter: the complete resolved codelist normally, or published codes when available_only is true."

Previous value: -"Machine-readable failure mode. Declared by this tool: `dataflow_not_found`: dataflow_id does not match any known dataflow on api.imf.org `dimension_not_found`: dimension_id does not match a dimension in the selected dataflow `structure_unavailable`: api.imf.org returns non-200 on the DSD endpoint `dataflow_list_unavailable`: The dataflow catalog that dataflow_id is resolved against could not be fetched — fires before the DSD lookup is attempted Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `dataflow_not_found`: dataflow_id does not match any known dataflow on api.imf.org `dimension_not_found`: dimension_id does not match a dimension in the selected dataflow `structure_unavailable`: api.imf.org returns non-200 on the DSD endpoint `dataflow_list_unavailable`: The dataflow catalog that dataflow_id is resolved against could not be fetched — fires before the DSD lookup is attempted `availability_unavailable`: available_only is true and the dataflow-wide availability constraint cannot be fetched or parsed Other values are possible when a failure originates below the handler."

Previous value: -[
-  "dataflow_not_found",
-  "dimension_not_found",
-  "structure_unavailable",
-  "dataflow_list_unavailable"
-]New value: +[
+  "dataflow_not_found",
+  "dimension_not_found",
+  "structure_unavailable",
+  "dataflow_list_unavailable",
+  "availability_unavailable"
+]

Added value: +{
+  "description": "Total series published by the dataflow. Present when available_only is true.",
+  "type": "number"
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Latest period with published data, or null when the constraint omits it."
+}

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "Earliest period with published data, or null when the constraint omits it."
+}

Previous value: -"Optional case-insensitive substring to search within each dimension's codelist (code ID and name). When set, returns all matching entries per dimension instead of the first-50 window — useful for large codelists like WEO INDICATOR (145 entries). Example: \"CPI\" or \"PCPIPCH\" surfaces consumer price index codes without hitting the 50-entry cap."New value: +"Optional case-insensitive substring to search within each dimension's codelist (code ID and name). Filtering runs before the 50-entry preview or selected-dimension page. Example: \"CPI\" or \"Constant prices\" surfaces matching WEO indicator codes."

Added value: +1

Added value: +{
+  "description": "Exact dimension ID from this tool, e.g. INDICATOR. Select one dimension to page beyond its preview.",
+  "minLength": 1,
+  "type": "string"
+}

Added value: +{
+  "description": "Entries to return from the selected dimension. Valid only with dimension_id; default 50, maximum 200.",
+  "maximum": 200,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Matching entries to skip in the selected dimension before this page. Valid only with dimension_id; default 0.",
+  "maximum": 9007199254740991,
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -[
-  {
-    "not": {
-      "required": [
-        "error"
-      ]
-    },
-    "required": [
-      "dataflow_id",
-      "agency_id",
-      "version",
-      "name",
-      "key_format",
-      "dimensions",
-      "source"
-    ]
-  },
-  {
-    "required": [
-      "error"
-    ]
-  }
-]New value: +[
+  {
+    "not": {
+      "required": [
+        "error"
+      ]
+    },
+    "required": [
+      "dataflow_id",
+      "agency_id",
+      "version",
+      "name",
+      "key_format",
+      "truncated",
+      "dimensions",
+      "source"
+    ]
+  },
+  {
+    "required": [
+      "error"
+    ]
+  }
+]

Added value: +{
+  "description": "Selected dimension ID. Absent when previews for every dimension were returned.",
+  "type": "string"
+}

Previous value: -"All dimensions of this dataflow with their codelists."New value: +"All dimension previews, or the one selected dimension page."

Previous value: -"Valid codes for this dimension. Up to 50 entries shown when no codelist_filter is set; use codelist_filter to search large codelists or the imf://database resource for the full list. Empty means the filter matched nothing when codelist_filter is echoed back, and that the codelist could not be resolved when it is not — see notice."New value: +"Valid codes for this dimension. Unselected previews show up to 50 entries after optional filtering. Select dimension_id and use limit/offset for a bounded page of up to 200 entries. Empty means the filter matched nothing when codelist_filter is echoed back, and that the codelist could not be resolved when it is not — see notice."

Previous value: -"True when the codelist has more than 50 entries and was truncated."New value: +"True when matching codes were omitted before or after this page."

Added value: +{
+  "description": "Codes matching codelist_filter before limit and offset are applied.",
+  "type": "number"
+}

Added value: +{
+  "description": "Offset for the next page when later matching codes remain.",
+  "type": "number"
+}

Added value: +{
+  "description": "Matching codes skipped before this dimension page.",
+  "type": "number"
+}

Added value: +{
+  "description": "Codes returned in this dimension page.",
+  "type": "number"
+}

Added value: +{
+  "description": "Codes in the complete resolved codelist before codelist_filter is applied.",
+  "type": "number"
+}

Previous value: -[
-  "id",
-  "name",
-  "position",
-  "codelist",
-  "codelist_truncated"
-]New value: +[
+  "id",
+  "name",
+  "position",
+  "codelist",
+  "codelist_truncated",
+  "unfiltered_count",
+  "matched_count",
+  "returned_count",
+  "offset"
+]

Previous value: -"Machine-readable failure mode. Declared by this tool: `dataflow_not_found`: dataflow_id does not match any known dataflow on api.imf.org `structure_unavailable`: api.imf.org returns non-200 on the DSD endpoint `dataflow_list_unavailable`: The dataflow catalog that dataflow_id is resolved against could not be fetched — fires before the DSD lookup is attempted Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `dataflow_not_found`: dataflow_id does not match any known dataflow on api.imf.org `dimension_not_found`: dimension_id does not match a dimension in the selected dataflow `structure_unavailable`: api.imf.org returns non-200 on the DSD endpoint `dataflow_list_unavailable`: The dataflow catalog that dataflow_id is resolved against could not be fetched — fires before the DSD lookup is attempted Other values are possible when a failure originates below the handler."

Previous value: -[
-  "dataflow_not_found",
-  "structure_unavailable",
-  "dataflow_list_unavailable"
-]New value: +[
+  "dataflow_not_found",
+  "dimension_not_found",
+  "structure_unavailable",
+  "dataflow_list_unavailable"
+]

Previous value: -"Populated when a codelist_filter matched no entries anywhere, or when a dimension has no resolvable codelist — the two produce the same empty array and need opposite next steps."New value: +"Populated when a codelist_filter matched no entries anywhere, or when a dimension has no resolvable codelist, or when offset is past the final match."

Added value: +{
+  "description": "True when any returned dimension page omits matching codes.",
+  "type": "boolean"
+}

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": [
+      "dataflow_id",
+      "agency_id",
+      "version",
+      "name",
+      "key_format",
+      "dimensions",
+      "source"
+    ]
+  },
+  {
+    "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: `dataflow_not_found`: dataflow_id does not match any known dataflow on api.imf.org `structure_unavailable`: api.imf.org returns non-200 on the DSD endpoint `dataflow_list_unavailable`: The dataflow catalog that dataflow_id is resolved against could not be fetched — fires before the DSD lookup is attempted Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "dataflow_not_found",
+            "structure_unavailable",
+            "dataflow_list_unavailable"
+          ],
+          "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: -[
-  "dataflow_id",
-  "agency_id",
-  "version",
-  "name",
-  "key_format",
-  "dimensions",
-  "source"
-]

Previous value: -"This dataflow's own description, matching what imf_list_databases reports for the same id — not the shared DSD's. Absent when the dataflow publishes none."New value: +"This dataflow's own description in full — not the shared DSD's, and not the shortened preview imf_list_databases returns for the same id. Absent when the dataflow publishes none."

Previous value: -"Extended description, if available."New value: +"This dataflow's own description, matching what imf_list_databases reports for the same id — not the shared DSD's. Absent when the dataflow publishes none."

Added value: +{
+  "description": "Echo of the codelist_filter that produced this result. Absent when no filter was applied — an empty codelist then means the codelist could not be resolved, not that the filter missed.",
+  "type": "string"
+}

Previous value: -"Valid codes for this dimension. Up to 50 entries shown when no codelist_filter is set; use codelist_filter to search large codelists or the imf://database resource for the full list."New value: +"Valid codes for this dimension. Up to 50 entries shown when no codelist_filter is set; use codelist_filter to search large codelists or the imf://database resource for the full list. Empty means the filter matched nothing when codelist_filter is echoed back, and that the codelist could not be resolved when it is not — see notice."

Previous value: -"Human-readable dimension name."New value: +"Human-readable dimension label from the DSD concept scheme, e.g. Weight Type for WGT_TYPE. Falls back to the dimension id when the structure names no concept."

Added value: +{
+  "description": "Populated when a codelist_filter matched no entries anywhere, or when a dimension has no resolvable codelist — the two produce the same empty array and need opposite next steps.",
+  "type": "string"
+}

Added value: +{
+  "description": "Version of the underlying data structure definition (DSD) that backs this dataflow. Differs from version when the dataflow references a shared DSD (e.g. IIP → DSD_BOP at 24.0.0).",
+  "type": "string"
+}

Added value: +{
+  "description": "Identifier of the underlying DSD, e.g. DSD_BOP. Several dataflows can share one DSD.",
+  "type": "string"
+}

Added value: +{
+  "description": "Optional case-insensitive substring to search within each dimension's codelist (code ID and name). When set, returns all matching entries per dimension instead of the first-50 window — useful for large codelists like WEO INDICATOR (145 entries). Example: \"CPI\" or \"PCPIPCH\" surfaces consumer price index codes without hitting the 50-entry cap.",
+  "type": "string"
+}

Previous value: -"Valid codes for this dimension. Up to 50 entries shown; full list available via the imf://database resource."New value: +"Valid codes for this dimension. Up to 50 entries shown when no codelist_filter is set; use codelist_filter to search large codelists or the imf://database resource for the full list."