Previous value: -"Breakdown dimension: naics (industry), psc (product/service code), awarding_agency, awarding_subagency, funding_agency, funding_subagency, cfda (assistance programs), recipient_duns, or recipient_parent_duns"New value: +"Breakdown dimension: naics (industry), psc (product/service code), awarding_agency, awarding_subagency, funding_agency, funding_subagency, cfda (assistance programs), or recipient_duns (recipients)"

Previous value: -[
-  "naics",
-  "psc",
-  "awarding_agency",
-  "awarding_subagency",
-  "funding_agency",
-  "funding_subagency",
-  "cfda",
-  "recipient_duns",
-  "recipient_parent_duns"
-]New value: +[
+  "naics",
+  "psc",
+  "awarding_agency",
+  "awarding_subagency",
+  "funding_agency",
+  "funding_subagency",
+  "cfda",
+  "recipient_duns"
+]

Added value: +false

Previous value: -"Awarding agency name filter"New value: +"Awarding agency name filter, top-tier only (e.g., \"Department of Defense\") — the toptier_name from usaspending_autocomplete_filters type=awarding_agency; a sub-agency name matches nothing"

Added value: +{
+  "description": "Filter by Assistance Listing (CFDA) program numbers, e.g. [\"15.507\"]: two digits, a dot, then three digits or capital letters (11.67A). Matches an award when any of its listings equals one of these exactly; several values match any of them. A matching award's primary listing can differ from the one requested, and amounts cover the whole award, not that listing's share. Only assistance awards (grants, direct payments, loans, other assistance) carry listings, so a call whose award types are all contracts or IDVs — including a contract default — is rejected as assistance_listings_type_mismatch. Use usaspending_autocomplete_filters type=cfda to look up numbers.",
+  "items": {
+    "description": "Assistance Listing number, e.g. 15.507",
+    "pattern": "^\\d{2}\\.[0-9A-Z]{3}$",
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Filter by Disaster Emergency Fund Codes (DEF), e.g. [\"Z\"], or [\"L\", \"M\", \"N\", \"O\", \"P\"] for COVID-19: 1–3 letters or digits, sent uppercased — the codes usaspending_disaster_spending takes and usaspending_get_agency lists. Matches awards of any type funded under any of these codes. Amounts cover the whole matching award, not the share funded by the code, and DEF-filtered totals can be negative. An unknown code is rejected with the list of codes USAspending accepts.",
+  "items": {
+    "description": "Disaster Emergency Fund Code, e.g. Z or L",
+    "pattern": "^[0-9A-Za-z]{1,3}$",
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Filter by Product and Service Codes (PSC), e.g. [\"Y1NE\"]: 1–4 letters or digits, sent uppercased. A shorter code covers every code under it (\"Y1\" covers \"Y1NE\"); several values match any of them. Only contracts and IDVs carry a PSC, so a call whose award types are all assistance types is rejected as psc_codes_type_mismatch, and pairing psc_codes with assistance_listings matches nothing, since no award carries both. Use usaspending_autocomplete_filters type=psc to look up codes.",
+  "items": {
+    "description": "Product and Service Code or prefix, e.g. Y1NE or Y1",
+    "pattern": "^[0-9A-Za-z]{1,4}$",
+    "type": "string"
+  },
+  "type": "array"
+}

Added value: +{
+  "description": "Assistance Listing numbers sent (comma-separated)",
+  "type": "string"
+}

Added value: +{
+  "description": "DEF codes sent, uppercased (comma-separated)",
+  "type": "string"
+}

Added value: +{
+  "description": "PSC codes sent, uppercased (comma-separated)",
+  "type": "string"
+}

Previous value: -"Machine-readable failure mode. Declared by this tool: `api_unavailable`: USAspending.gov API is unreachable or returns an error. `api_timeout`: USAspending.gov did not respond before the request deadline elapsed. `date_range_inverted`: Both filters.time_period_start and filters.time_period_end were supplied and the start falls after the end. `date_before_earliest`: The resolved start date precedes the 2007-10-01 earliest date this endpoint can search. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `api_unavailable`: USAspending.gov API is unreachable or returns an error. `api_timeout`: USAspending.gov did not respond before the request deadline elapsed. `date_range_inverted`: Both filters.time_period_start and filters.time_period_end were supplied and the start falls after the end. `date_before_earliest`: The resolved start date precedes the 2007-10-01 earliest date this endpoint can search. `assistance_listings_type_mismatch`: filters.assistance_listings was given while every code in filters.award_type_codes is a contract or IDV code. `psc_codes_type_mismatch`: filters.psc_codes was given while every code in filters.award_type_codes is an assistance code. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "api_unavailable",
-  "api_timeout",
-  "date_range_inverted",
-  "date_before_earliest"
-]New value: +[
+  "api_unavailable",
+  "api_timeout",
+  "date_range_inverted",
+  "date_before_earliest",
+  "assistance_listings_type_mismatch",
+  "psc_codes_type_mismatch"
+]

Previous value: -"Names a date bound that was filled in because only the other was supplied, and suggests how to broaden filters when results are empty. Absent when neither applies."New value: +"Names a date bound that was filled in because only the other was supplied, and — when results are empty — names any Assistance Listing, PSC, or DEF codes sent and suggests how to broaden filters. Absent when neither applies."

Previous value: -"Code value (NAICS, PSC, CFDA number, etc.)"New value: +"Code value (NAICS, PSC, CFDA number, recipient DUNS, etc.)"

Added value: +{
+  "description": "Recipient hash ID (recipient_duns rows) — pass to usaspending_get_recipient for the profile. Absent when upstream has none.",
+  "type": "string"
+}

Added value: +{
+  "description": "Recipient Unique Entity Identifier (recipient_duns rows). Absent when upstream has none.",
+  "type": "string"
+}

Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "Date as YYYY-MM-DD; month and day may be unpadded",
+    "pattern": "^\\d{4}-\\d{1,2}-\\d{1,2}$",
+    "type": "string"
+  }
+]

Previous value: -"End date (YYYY-MM-DD)"New value: +"End date (YYYY-MM-DD). Given alone, the window starts at 2007-10-01, the earliest searchable date."

Removed value: -"string"

Added value: +[
+  {
+    "const": "",
+    "type": "string"
+  },
+  {
+    "description": "Date as YYYY-MM-DD; month and day may be unpadded",
+    "pattern": "^\\d{4}-\\d{1,2}-\\d{1,2}$",
+    "type": "string"
+  }
+]

Previous value: -"Start date (YYYY-MM-DD)"New value: +"Start date (YYYY-MM-DD), 2007-10-01 or later. Given alone, the window runs through today (UTC)."

Removed value: -"string"

Previous value: -"End date filter applied (YYYY-MM-DD)"New value: +"End date sent (YYYY-MM-DD), including a filled-in end"

Previous value: -"Start date filter applied (YYYY-MM-DD)"New value: +"Start date sent (YYYY-MM-DD), including a filled-in start"

Previous value: -"Machine-readable failure mode. Declared by this tool: `api_unavailable`: USAspending.gov API is unreachable or returns an error. `api_timeout`: USAspending.gov did not respond before the request deadline elapsed. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `api_unavailable`: USAspending.gov API is unreachable or returns an error. `api_timeout`: USAspending.gov did not respond before the request deadline elapsed. `date_range_inverted`: Both filters.time_period_start and filters.time_period_end were supplied and the start falls after the end. `date_before_earliest`: The resolved start date precedes the 2007-10-01 earliest date this endpoint can search. Other values are possible when a failure originates below the handler."

Previous value: -[
-  "api_unavailable",
-  "api_timeout"
-]New value: +[
+  "api_unavailable",
+  "api_timeout",
+  "date_range_inverted",
+  "date_before_earliest"
+]

Previous value: -"Recovery hint when results are empty — suggests how to broaden filters. Absent when results are present."New value: +"Names a date bound that was filled in because only the other was supplied, and suggests how to broaden filters when results are empty. Absent when neither applies."

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": [
+      "category",
+      "results",
+      "page_metadata",
+      "page",
+      "has_next"
+    ]
+  },
+  {
+    "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: `api_unavailable`: USAspending.gov API is unreachable or returns an error. `api_timeout`: USAspending.gov did not respond before the request deadline elapsed. Other values are possible when a failure originates below the handler.",
+          "examples": [
+            "api_unavailable",
+            "api_timeout"
+          ],
+          "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: -[
-  "category",
-  "results",
-  "page_metadata",
-  "page",
-  "has_next"
-]

Removed value: -{
-  "description": "Total number of items in this category (when available)",
-  "type": "number"
-}

Added value: +{
+  "description": "Total number of items in this category (when available)",
+  "type": "number"
+}

Added value: +{
+  "description": "Awarding agency name filter applied",
+  "type": "string"
+}

Added value: +{
+  "description": "Keyword filters applied (comma-separated)",
+  "type": "string"
+}

Added value: +{
+  "description": "NAICS code filters applied (comma-separated)",
+  "type": "string"
+}

Added value: +{
+  "description": "End date filter applied (YYYY-MM-DD)",
+  "type": "string"
+}

Added value: +{
+  "description": "Start date filter applied (YYYY-MM-DD)",
+  "type": "string"
+}

Added value: +{
+  "description": "Whether there are more pages",
+  "type": "boolean"
+}

Removed value: -{
-  "description": "Recovery hint when results are empty — suggests how to broaden filters. Absent when results are present.",
-  "type": "string"
-}

Added value: +{
+  "description": "Recovery hint when results are empty — suggests how to broaden filters. Absent when results are present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Current page returned",
+  "type": "number"
+}

Added value: +{
+  "description": "Total number of items in this category (when available)",
+  "type": "number"
+}

Previous value: -[
-  "category",
-  "results",
-  "page_metadata"
-]New value: +[
+  "category",
+  "results",
+  "page_metadata",
+  "page",
+  "has_next"
+]