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"
+}

Previous value: -"Geographic granularity: state (50 states), county (county-level), or district (congressional district)"New value: +"Geographic granularity: state (states, DC, and territories), county (county-level), or district (congressional district)"

Previous value: -"Maximum geographic areas to return, ranked by aggregated_amount descending (1–500). The upstream endpoint is not paginated — it returns every matching area in one response — so this caps client-side. A nationwide county query matches over 3,000 areas."New value: +"Maximum geographic areas to return, ranked by aggregated_amount descending (1–500). The upstream endpoint is not paginated — it returns every matching area in one response — so this caps client-side. A nationwide county query matches over 3,000 areas; use shape_codes to retrieve one ranked past the cap."

Added value: +{
+  "description": "Return only these areas (1–500 codes), in the shape_code form this tool returns for geo_layer: 2-letter postal code for state (\"NY\"), 5-digit state + county FIPS for county (\"36117\" is Wayne County, NY), or 4-digit state FIPS + 2-digit district number for district (\"3623\" is NY-23, \"5600\" is Wyoming's at-large seat). Selection runs over every area the filters matched, so it reaches areas ranked past limit; selected areas stay ranked by aggregated_amount and capped at limit. A code that matches no area is named in the notice.",
+  "items": {
+    "description": "One area code: 2-letter postal code (e.g. \"NY\"), 5-digit county FIPS (e.g. \"36117\"), or 4-digit district code (e.g. \"3623\")",
+    "pattern": "^(?:[A-Za-z]{2}|\\d{4,5})$",
+    "type": "string"
+  },
+  "maxItems": 500,
+  "minItems": 1,
+  "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"
+}

Added value: +{
+  "description": "Area codes listed in shape_codes, letters uppercased and duplicates removed (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: -"How to reach areas omitted by limit, which time-period bound was filled in when only the other was supplied, and how to broaden filters when results are empty. Absent when none applies."New value: +"How to reach areas omitted by limit, which shape_codes matched no area, which time-period bound was filled in when only the other was supplied, and — when the filters matched no area — any Assistance Listing, PSC, or DEF codes sent and how to broaden filters. Absent when none applies."

Removed value: -{
-  "description": "Number of awards in this area",
-  "type": "number"
-}

Previous value: -"Geographic identifier (FIPS state code, county FIPS, or district code)"New value: +"Area code, the form shape_codes takes: 2-letter postal code (state), 5-digit state + county FIPS (county), or 4-digit state FIPS + district number (district). Absent on the row for spending with no recorded location."

Previous value: -"Number of geographic areas the filters matched, before limit was applied"New value: +"Number of geographic areas the filters matched, before shape_codes selection and limit were applied"

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 of time period in ISO 8601 format (YYYY-MM-DD)"New value: +"End of time period (YYYY-MM-DD). Given alone, the period 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 of time period in ISO 8601 format (YYYY-MM-DD)"New value: +"Start of time period (YYYY-MM-DD), 2007-10-01 or later. Given alone, the period runs through today (UTC)."

Removed value: -"string"

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

Previous value: -"Start date filter applied (YYYY-MM-DD)"New value: +"Start of the time period 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: +"How to reach areas omitted by limit, which time-period bound was filled in when only the other was supplied, and how to broaden filters when results are empty. Absent when none 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": [
+      "scope",
+      "geo_layer",
+      "results",
+      "total",
+      "total_areas_available",
+      "applied_scope",
+      "applied_geo_layer",
+      "area_count"
+    ]
+  },
+  {
+    "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: -[
-  "scope",
-  "geo_layer",
-  "results",
-  "total",
-  "total_areas_available",
-  "applied_scope",
-  "applied_geo_layer",
-  "area_count"
-]

Previous value: -"Award type codes: A/B/C/D (contracts), 02–05 (grants), 06/10 (direct payments), 07/08 (loans)"New value: +"Award type codes: A/B/C/D (contracts), IDV_A–IDV_E (IDVs), 02–05 (grants), 06/10 (direct payments), 07/08 (loans), 09/11 (insurance and other assistance), -1 (unspecified). Groups may be mixed here. Omit to aggregate every type."

Added value: +{
+  "default": 50,
+  "description": "Maximum geographic areas to return, ranked by aggregated_amount descending (1–500). The upstream endpoint is not paginated — it returns every matching area in one response — so this caps client-side. A nationwide county query matches over 3,000 areas.",
+  "maximum": 500,
+  "minimum": 1,
+  "type": "integer"
+}

Added value: +{
+  "description": "Disclosure that no filters were supplied, so award_type_codes defaulted to the complete set. Absent when the caller supplied at least one filter.",
+  "type": "string"
+}

Added value: +{
+  "description": "The limit that was applied.",
+  "type": "number"
+}

Added value: +{
+  "description": "Number of geographic areas returned.",
+  "type": "number"
+}

Added value: +{
+  "description": "Number of geographic areas the filters matched, before limit was applied",
+  "type": "number"
+}

Added value: +{
+  "description": "True when the area list was capped at limit.",
+  "type": "boolean"
+}

Added value: +{
+  "description": "Obligation amount of the lowest-ranked area shown — an upper bound on omitted ones.",
+  "type": "number"
+}

Previous value: -[
-  "scope",
-  "geo_layer",
-  "results",
-  "total",
-  "applied_scope",
-  "applied_geo_layer",
-  "area_count"
-]New value: +[
+  "scope",
+  "geo_layer",
+  "results",
+  "total",
+  "total_areas_available",
+  "applied_scope",
+  "applied_geo_layer",
+  "area_count"
+]

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": "Recovery hint when results are empty — suggests how to broaden filters. Absent when results are present.",
+  "type": "string"
+}

Added value: +{
+  "description": "Geographic granularity applied: state, county, or district",
+  "type": "string"
+}

Added value: +{
+  "description": "Location scope applied: place_of_performance or recipient_location",
+  "type": "string"
+}

Added value: +{
+  "description": "Number of geographic areas returned",
+  "type": "number"
+}

Previous value: -[
-  "scope",
-  "geo_layer",
-  "results",
-  "total"
-]New value: +[
+  "scope",
+  "geo_layer",
+  "results",
+  "total",
+  "applied_scope",
+  "applied_geo_layer",
+  "area_count"
+]