Previous value: -"Total result count (may be approximate for itemized)."New value: +"Total matching contributions (itemized mode). Check count_is_approximate before quoting it as a figure."

Added value: +{
+  "description": "True when OpenFEC reports count as an estimate rather than a tally, which it does on its highest-volume queries. Absent means the count is a tally.",
+  "type": "boolean"
+}

Previous value: -"Guidance when no contributions matched — echoes filters and suggests how to broaden."New value: +"Guidance when the response needs context: how to broaden a search that matched nothing, which requested position ran out when contributions did match, or that the total is an estimate."

Added value: +{
+  "description": "True when OpenFEC reports this count as an estimate rather than a tally, which it does on its highest-volume datasets. Absent means the count is a tally. An estimated count — and the pages derived from it — can be off by a wide margin; treat it as an order of magnitude, not a figure to quote.",
+  "type": "boolean"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `itemized_requires_committee_id`: Itemized mode invoked without a committee_id `aggregate_requires_committee_id`: by_employer or by_occupation aggregate without a committee_id `itemized_only_filters_in_aggregate_mode`: An itemized-only filter was supplied alongside an aggregate mode, which cannot apply it `inputs_not_applicable_to_mode`: The resolved Schedule A endpoint does not accept one or more explicitly supplied inputs Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `itemized_requires_committee_id`: Itemized mode invoked without a committee_id. `aggregate_requires_committee_id`: by_employer or by_occupation aggregate without a committee_id. `itemized_only_filters_in_aggregate_mode`: An itemized-only filter was supplied alongside an aggregate mode, which cannot apply it. `inputs_not_applicable_to_mode`: The resolved Schedule A endpoint does not accept one or more explicitly supplied inputs. Other values are possible when a failure originates below the handler."

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

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

Removed value: -1

Previous value: -"Page number (1-indexed) for the aggregate modes. Ignored in itemized mode, which paginates with cursor. Read pagination.pages in the response to see how many pages exist."New value: +"Page number (1-indexed) for aggregate modes. Explicit page is rejected in itemized mode, which paginates with cursor. Defaults to 1 for aggregates."

Previous value: -"Machine-readable failure mode. Declared by this tool: `itemized_requires_committee_id`: Itemized mode invoked without a committee_id `aggregate_requires_committee_id`: by_employer or by_occupation aggregate without a committee_id `itemized_only_filters_in_aggregate_mode`: An itemized-only filter was supplied alongside an aggregate mode, which cannot apply it Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `itemized_requires_committee_id`: Itemized mode invoked without a committee_id `aggregate_requires_committee_id`: by_employer or by_occupation aggregate without a committee_id `itemized_only_filters_in_aggregate_mode`: An itemized-only filter was supplied alongside an aggregate mode, which cannot apply it `inputs_not_applicable_to_mode`: The resolved Schedule A endpoint does not accept one or more explicitly supplied inputs Other values are possible when a failure originates below the handler."

Previous value: -[
-  "itemized_requires_committee_id",
-  "aggregate_requires_committee_id",
-  "itemized_only_filters_in_aggregate_mode"
-]New value: +[
+  "itemized_requires_committee_id",
+  "aggregate_requires_committee_id",
+  "itemized_only_filters_in_aggregate_mode",
+  "inputs_not_applicable_to_mode"
+]

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": [
+      "results",
+      "mode",
+      "search_criteria",
+      "totalCount"
+    ]
+  },
+  {
+    "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: `itemized_requires_committee_id`: Itemized mode invoked without a committee_id `aggregate_requires_committee_id`: by_employer or by_occupation aggregate without a committee_id `itemized_only_filters_in_aggregate_mode`: An itemized-only filter was supplied alongside an aggregate mode, which cannot apply it Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "itemized_requires_committee_id",
+            "aggregate_requires_committee_id",
+            "itemized_only_filters_in_aggregate_mode"
+          ],
+          "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: -[
-  "results",
-  "mode",
-  "search_criteria",
-  "totalCount"
-]

Added value: +{
+  "additionalProperties": {},
+  "description": "The committee every row in this response belongs to, carried once instead of repeated in each row. Present only when the query was scoped to a single committee_id; otherwise each row keeps its own committee object.",
+  "properties": {},
+  "type": "object"
+}

Added value: +{
+  "description": "Query mode as the server resolved it. \"by_size\" and \"by_state\" resolve to \"by_size_candidate\" / \"by_state_candidate\" when scoped by candidate_id — a different endpoint with different row shapes — so read this rather than assuming the mode you sent.",
+  "enum": [
+    "itemized",
+    "by_size",
+    "by_state",
+    "by_employer",
+    "by_occupation",
+    "by_size_candidate",
+    "by_state_candidate"
+  ],
+  "type": "string"
+}

Previous value: -"Echo of the search filters that produced this result set. Populated when results are empty to help diagnose why nothing matched."New value: +"Echo of the search filters this call applied, as the server parsed them, minus paging arguments. Always present — compare it against what you sent to confirm every filter was honoured."

Previous value: -[
-  "results",
-  "totalCount"
-]New value: +[
+  "results",
+  "mode",
+  "search_criteria",
+  "totalCount"
+]

Added value: +{
+  "default": 1,
+  "description": "Page number (1-indexed) for the aggregate modes. Ignored in itemized mode, which paginates with cursor. Read pagination.pages in the response to see how many pages exist.",
+  "maximum": 9007199254740991,
+  "minimum": 1,
+  "type": "integer"
+}

Previous value: -"Opaque pagination cursor from a previous response. Itemized mode only (keyset pagination)."New value: +"Opaque pagination cursor from a previous response of this tool. Itemized mode only (keyset pagination). Valid only for an otherwise-identical call — changing any other argument, including sort, rejects the cursor; omit it to start over."

Previous value: -"Sort field. Itemized only."New value: +"Sort field. A \"-\" prefix sorts descending: use \"-contribution_receipt_amount\" for the largest receipts first, since the ascending form leads with the most negative rows (refunds, reattributions, redesignations). Itemized only; OpenFEC sorts by \"-contribution_receipt_date\" when omitted."

Previous value: -[
-  "contribution_receipt_date",
-  "contribution_receipt_amount"
-]New value: +[
+  "contribution_receipt_date",
+  "-contribution_receipt_date",
+  "contribution_receipt_amount",
+  "-contribution_receipt_amount"
+]

Removed value: -"^[HSP][0-9A-Z]+$"

Removed value: -"^C\\d+$"

Added value: +{
+  "description": "Guidance when no contributions matched — echoes filters and suggests how to broaden.",
+  "type": "string"
+}

Added value: +{
+  "description": "Total matching contributions or aggregate rows.",
+  "type": "number"
+}

Previous value: -[
-  "results"
-]New value: +[
+  "results",
+  "totalCount"
+]

Previous value: -"Candidate ID. Enables by_size and by_state aggregates without a committee_id."New value: +"Candidate ID (e.g., P00003392). Get IDs from openfec_search_candidates results. Enables by_size and by_state aggregates without a committee_id."

Added value: +"^[HSP][0-9A-Z]+$"

Previous value: -"Receiving committee ID (e.g., C00703975)."New value: +"Receiving committee ID (e.g., C00703975). Get IDs from openfec_search_committees results."

Added value: +"^C\\d+$"

Previous value: -"Results per page (max 100)."New value: +"Results per page."

Added value: +100

Added value: +1

Previous value: -"number"New value: +"integer"

Previous value: -"Total results."New value: +"Total result count."

Previous value: -"Current page number."New value: +"Current page number (1-indexed)."

Previous value: -"Total pages."New value: +"Total number of pages."

Previous value: -"Contribution records (itemized) or aggregate rows."New value: +"Contribution result set; itemized records or aggregate buckets depending on mode."

Previous value: -"A contribution record (itemized entry) or an aggregate row."New value: +"Itemized contribution record (mode=itemized) or aggregate row (mode=by_size, by_state, by_employer, by_occupation)."

Added value: +"A contribution record (itemized entry) or an aggregate row."

Added value: +{}

Removed value: -{
-  "type": "string"
-}

Added value: +{}

Removed value: -{
-  "type": "string"
-}