Previous value: -"Minimum quality threshold (default: medium)"New value: +"Minimum record-completeness tier (default: medium). any removes this quality-tier filter; relevance, access and other filters still apply."

Previous value: -"When sam_filters.place_of_performance_state is also set: false (default) demotes results with no confirmed location below confirmed matches and caveats them; true excludes them instead of demoting."New value: +"With a recognized location, requests geographic filtering; nationwide or unspecified records and explicitly broader fallbacks may remain. Check geographyFilterOutcome and warnings. With sam_filters.place_of_performance_state (or pop_state in batch), true additionally excludes records without a confirmed performance location; false demotes and caveats them."

Added value: +{
+  "description": "Top-level federal department or independent agency, e.g. \"Department of Energy\", \"DOE\", \"Defense\", \"GSA\". Matched against the live SAM.gov department facet (agency name, acronym, or \"Department of X\" phrasing all resolve); an unrecognized value is applied as-is and reported in the response as departmentFilter.",
+  "type": "string"
+}

Previous value: -"State code (e.g., \"CA\", \"TX\")"New value: +"State code (e.g., \"CA\", \"TX\"). Alias: pop_state (used by search_grantsplus/batch_search_procurement) is also accepted here."

Added value: +{
+  "description": "Alias for place_of_performance_state — state code (e.g., \"CA\", \"TX\"). When both are sent, place_of_performance_state wins.",
+  "type": "string"
+}

Previous value: -"Product Service Code"New value: +"Product Service Code. NOT YET APPLIED to results — accepted for schema compatibility with other tools but currently reported in the response as an ignored filter; do not rely on it to narrow results."

Added value: +{
+  "description": "When sam_filters.place_of_performance_state is also set: false (default) demotes results with no confirmed location below confirmed matches and caveats them; true excludes them instead of demoting.",
+  "type": "boolean"
+}

Previous value: -"Backwards-compatible alias for posted_within_days. Only opportunities WE ADDED (ingested) in the last N days for recurring/delta checks (\"what is new since my last check\"). Additive to all other filters. In queryless browse mode without a single source, the recency window is sampled across sources round-robin by ingest recency so one bulk harvester cannot own the digest; each source remains newest first. The response includes newSince and windowCoverage: sourcesSampled counts distinct sources returned by the grouped provider query before MCP quality, judge, recency-withhold, and page filters; it is absent when no grouped sample was available, including when sampling was not attempted, and 0 means the grouped query succeeded but returned no sourced rows; sourcesServed counts distinct sources delivered on this page. windowIncomplete/incompleteReason is separate from ceilingTruncated, which is true only when the 2,000-row ceiling excluded records. Not the opportunity posted date or deadline."New value: +"Backwards-compatible alias for posted_within_days. Only opportunities WE ADDED (ingested) in the last N days for recurring/delta checks (\"what is new since my last check\"). Additive to all other filters. In queryless browse mode without a single source, the recency window is sampled across sources round-robin by ingest recency so one bulk harvester cannot own the digest; each source remains newest first. The response includes newSince and windowCoverage: sourcesSampled counts distinct sources returned by the grouped provider query before MCP quality, judge, recency-withhold, and page filters; it is absent when no grouped sample was available, including when sampling was not attempted, and 0 means the grouped query succeeded but returned no sourced rows; sourcesServed counts distinct sources delivered on this page. windowCoverage.order is \"recency\" for the queryless browse digest or \"relevance\" when a query is present. windowIncomplete/incompleteReason is separate from ceilingTruncated, which is true only when the 2,000-row ceiling excluded records; ceilingTruncated and hardCeiling are present only when order is \"recency\" and are omitted entirely under \"relevance\" (query mode never walks past a single bounded fetch, so no ceiling logic runs). Not the opportunity posted date or deadline."

Previous value: -"Preferred alias for new_within_days: only opportunities WE ADDED (ingested) in the last N days. In queryless browse mode without a single source, the recency window is sampled across sources round-robin by ingest recency so one bulk harvester cannot own the digest; each source remains newest first. In windowCoverage, sourcesSampled counts distinct sources returned by the grouped provider query before MCP quality, judge, recency-withhold, and page filters; it is absent when no grouped sample was available, including when sampling was not attempted, and 0 means the grouped query succeeded but returned no sourced rows; sourcesServed counts distinct sources delivered on this page. windowIncomplete/incompleteReason is separate from ceilingTruncated, which is true only when the 2,000-row ceiling excluded records. Uses the same ingest freshness field as newSince/recurring checks; not the opportunity posted date or deadline. If both posted_within_days and new_within_days are supplied, posted_within_days wins."New value: +"Preferred alias for new_within_days: only opportunities WE ADDED (ingested) in the last N days. In queryless browse mode without a single source, the recency window is sampled across sources round-robin by ingest recency so one bulk harvester cannot own the digest; each source remains newest first. In windowCoverage, sourcesSampled counts distinct sources returned by the grouped provider query before MCP quality, judge, recency-withhold, and page filters; it is absent when no grouped sample was available, including when sampling was not attempted, and 0 means the grouped query succeeded but returned no sourced rows; sourcesServed counts distinct sources delivered on this page. windowCoverage.order is \"recency\" for the queryless browse digest or \"relevance\" when a query is present. windowIncomplete/incompleteReason is separate from ceilingTruncated, which is true only when the 2,000-row ceiling excluded records; ceilingTruncated and hardCeiling are present only when order is \"recency\" and are omitted entirely under \"relevance\" (query mode never walks past a single bounded fetch, so no ceiling logic runs). Uses the same ingest freshness field as newSince/recurring checks; not the opportunity posted date or deadline. If both posted_within_days and new_within_days are supplied, posted_within_days wins."

Previous value: -"Backwards-compatible alias for posted_within_days. Only opportunities WE ADDED (ingested) in the last N days — for recurring/delta checks (\"what is new since my last check\"). Additive to all other filters. Sorts newest-ingested-first; response includes newSince.newCount and the newest/oldest ingest timestamp in the window. Not the opportunity posted date or deadline."New value: +"Backwards-compatible alias for posted_within_days. Only opportunities WE ADDED (ingested) in the last N days for recurring/delta checks (\"what is new since my last check\"). Additive to all other filters. In queryless browse mode without a single source, the recency window is sampled across sources round-robin by ingest recency so one bulk harvester cannot own the digest; each source remains newest first. The response includes newSince and windowCoverage: sourcesSampled counts distinct sources returned by the grouped provider query before MCP quality, judge, recency-withhold, and page filters; it is absent when no grouped sample was available, including when sampling was not attempted, and 0 means the grouped query succeeded but returned no sourced rows; sourcesServed counts distinct sources delivered on this page. windowIncomplete/incompleteReason is separate from ceilingTruncated, which is true only when the 2,000-row ceiling excluded records. Not the opportunity posted date or deadline."

Previous value: -"Preferred alias for new_within_days: only opportunities WE ADDED (ingested) in the last N days. Uses the same ingest freshness field as newSince/recurring checks; not the opportunity posted date or deadline. If both posted_within_days and new_within_days are supplied, posted_within_days wins."New value: +"Preferred alias for new_within_days: only opportunities WE ADDED (ingested) in the last N days. In queryless browse mode without a single source, the recency window is sampled across sources round-robin by ingest recency so one bulk harvester cannot own the digest; each source remains newest first. In windowCoverage, sourcesSampled counts distinct sources returned by the grouped provider query before MCP quality, judge, recency-withhold, and page filters; it is absent when no grouped sample was available, including when sampling was not attempted, and 0 means the grouped query succeeded but returned no sourced rows; sourcesServed counts distinct sources delivered on this page. windowIncomplete/incompleteReason is separate from ceilingTruncated, which is true only when the 2,000-row ceiling excluded records. Uses the same ingest freshness field as newSince/recurring checks; not the opportunity posted date or deadline. If both posted_within_days and new_within_days are supplied, posted_within_days wins."

Previous value: -[
-  {
-    "required": [
-      "query"
-    ]
-  },
-  {
-    "required": [
-      "queries"
-    ]
-  }
-]New value: +[
+  {
+    "required": [
+      "query"
+    ]
+  },
+  {
+    "required": [
+      "queries"
+    ]
+  },
+  {
+    "required": [
+      "source"
+    ]
+  },
+  {
+    "required": [
+      "organization"
+    ]
+  }
+]

Added value: +[
+  {
+    "required": [
+      "query"
+    ]
+  },
+  {
+    "required": [
+      "queries"
+    ]
+  }
+]

Added value: +{
+  "description": "Batch mode only: controls response verbosity (minimal/compact [default]/full). Ignored in single-query mode.",
+  "enum": [
+    "minimal",
+    "compact",
+    "full"
+  ],
+  "type": "string"
+}

Added value: +{
+  "description": "Batch mode only: token budget for the response (default 4000). Server auto-caps results to fit. Ignored in single-query mode.",
+  "minimum": 500,
+  "type": "number"
+}

Added value: +{
+  "description": "Batch mode only: maximum merged results to return (default 10). Ignored in single-query mode (use limit).",
+  "minimum": 1,
+  "type": "number"
+}

Added value: +{
+  "description": "Batch mode only: number of merged results to skip for pagination (default 0). Ignored in single-query mode.",
+  "minimum": 0,
+  "type": "number"
+}

Added value: +{
+  "description": "BATCH MODE (paid, replaces batch_search_procurement): array of 2-5 search queries to run in parallel, dedupe, and merge. Example for IT services: [\"IT services contract\", \"software development federal\", \"technology consulting government\", \"computer services procurement\"]. When set, query is ignored and the batch response params (detail_level, max_results, offset, max_response_tokens) apply.",
+  "items": {
+    "type": "string"
+  },
+  "maxItems": 5,
+  "minItems": 1,
+  "type": "array"
+}

Previous value: -"Natural language search query"New value: +"Natural language search query. Provide either query (single search) or queries (batch mode) — exactly one."

Removed value: -[
-  "query"
-]

Added value: +{
+  "description": "Filter to a specific source/domain, e.g. \"sam.gov\" or an agency source domain.",
+  "type": "string"
+}

Previous value: -"Only opportunities WE ADDED (ingested) in the last N days — for recurring/delta checks (\"what is new since my last check\"). Additive to all other filters. Sorts newest-ingested-first; response includes newSince.newCount and the newest/oldest ingest timestamp in the window. Not the opportunity posted date or deadline."New value: +"Backwards-compatible alias for posted_within_days. Only opportunities WE ADDED (ingested) in the last N days — for recurring/delta checks (\"what is new since my last check\"). Additive to all other filters. Sorts newest-ingested-first; response includes newSince.newCount and the newest/oldest ingest timestamp in the window. Not the opportunity posted date or deadline."

Added value: +{
+  "description": "Preferred alias for new_within_days: only opportunities WE ADDED (ingested) in the last N days. Uses the same ingest freshness field as newSince/recurring checks; not the opportunity posted date or deadline. If both posted_within_days and new_within_days are supplied, posted_within_days wins.",
+  "type": "number"
+}

Previous value: -"Stateless alternative to new_within_days: ISO 8601 instant. Only opportunities ingested at/after this instant. Store the previous response newSince.newest and pass it here to manage your own watermark."New value: +"Stateless alternative to posted_within_days/new_within_days: ISO 8601 instant. Only opportunities ingested at/after this instant. Store the previous response newSince.newest and pass it here to manage your own watermark."

Added value: +{
+  "description": "Only opportunities WE ADDED (ingested) in the last N days — for recurring/delta checks (\"what is new since my last check\"). Additive to all other filters. Sorts newest-ingested-first; response includes newSince.newCount and the newest/oldest ingest timestamp in the window. Not the opportunity posted date or deadline.",
+  "type": "number"
+}

Added value: +{
+  "description": "Stateless alternative to new_within_days: ISO 8601 instant. Only opportunities ingested at/after this instant. Store the previous response newSince.newest and pass it here to manage your own watermark.",
+  "type": "string"
+}

Previous value: -"Set-aside type: 8A, HUBZone, WOSB, SDVOSB, etc."New value: +"Set-aside type. Supported: SDVOSB, VOSB, WOSB, EDWOSB, 8a/8(a), HUBZone, SBA/\"Small Business\" (each expands to all matching SAM codes and CSV labels). Actually filters results."

Added value: +"Common natural-language phrasing (e.g. \"501(c)(3) nonprofit\") is also parsed; unparseable values are ignored with an explicit note in the response."