changedInput schema / properties / county / description
Previous value: -"Filter by designated area / county name substring (e.g., Harris, Los Angeles). Case-insensitive."New value: +"Filter by designated area / county name (e.g., Harris, Los Angeles, dekalb). Case-insensitive substring match: harris also matches Harrison. Selects the declarations that designated a matching area; designated_area_count and the program flags still describe the whole declaration, and matched_areas lists the matching areas."
changedInput schema / properties / date_from / description
Previous value: -"Start of the declaration date range as a calendar date in YYYY-MM-DD format (e.g., 2024-01-01). Inclusive."New value: +"Start of the declaration date range as a calendar date in YYYY-MM-DD format (e.g., 2024-01-01). Inclusive; not after date_to."
changedInput schema / properties / date_to / description
Previous value: -"End of the declaration date range as a calendar date in YYYY-MM-DD format (e.g., 2024-12-31). Inclusive."New value: +"End of the declaration date range as a calendar date in YYYY-MM-DD format (e.g., 2024-12-31). Inclusive; equal to date_from for a single day."
changedInput schema / properties / incident_type / description
Previous value: -"Incident type filter (e.g., Flood, Hurricane, Tornado, Fire, Earthquake, Severe Storm). Case-insensitive substring match."New value: +"Incident type filter (e.g., Flood, Hurricane, Tornado, Fire, Earthquake, Severe Storm). Case-insensitive substring match: storm also matches Snowstorm and Winter Storm."
changedInput schema / properties / limit / description
Previous value: -"Maximum number of unique disaster declarations to return (1–1000, default 50)."New value: +"Maximum number of unique disaster declarations to return (1–1000, default 50). A page also stops at 100,000 characters of declarations (roughly 290 declarations, about 190 with county); when either bound leaves matching declarations out, next_offset names the offset to continue from."
changedInput schema / properties / offset / description
Previous value: -"Pagination offset in declarations (default 0). Use with limit to page through results."New value: +"Pagination offset in declarations (default 0). Pass the previous page’s next_offset to continue."
addedOutput schema / properties / area_totals_unavailable
Added value: +{
+ "description": "True when county is set and reading the returned declarations’ full designated-area rows failed: designated_area_count and the ia/pa/hm flags then count only the areas county matched, and the notice names the cause. Absent otherwise.",
+ "type": "boolean"
+}
changedOutput schema / properties / declarations / description
Previous value: -"Disaster declarations matching the search, one entry per unique disaster number."New value: +"Disaster declarations matching the search from offset onward, one entry per unique disaster number, bounded by limit and by 100,000 characters of declarations."
changedOutput schema / properties / declarations / items / properties / designated_area_count / description
Previous value: -"Number of counties/municipalities designated — use fema_get_disaster for the full area list."New value: +"Number of counties/municipalities the whole declaration designated, also when county is set — use fema_get_disaster for the full area list."
changedOutput schema / properties / declarations / items / properties / hm_declared / description
Previous value: -"True when Hazard Mitigation grants were declared."New value: +"True when Hazard Mitigation grants were declared for any area of the declaration, also when county is set."
changedOutput schema / properties / declarations / items / properties / ia_declared / description
Previous value: -"True when the Individuals and Households Program (IHP) was declared — indicates IA housing/personal grants are available."New value: +"True when the Individuals and Households Program (IHP) was declared for any area of the declaration — indicates IA housing/personal grants are available. Describes the whole declaration also when county is set; matched_areas carries each matched area’s own flag."
addedOutput schema / properties / declarations / items / properties / matched_areas
Added value: +{
+ "description": "The designated areas of this declaration that county matched, each with the programs declared for that area — which can differ from the declaration: an area designated for PA and HM only has ia_declared false. Present only when county is set.",
+ "items": {
+ "additionalProperties": false,
+ "description": "One designated area that county matched, with its own program flags.",
+ "properties": {
+ "area": {
+ "description": "Name of the designated area, as stored (e.g., \"Bexar (County)\").",
+ "type": "string"
+ },
+ "fips_county_code": {
+ "description": "3-digit county FIPS code. Absent when not recorded.",
+ "type": "string"
+ },
+ "fips_state_code": {
+ "description": "2-digit state FIPS code. Absent when not recorded.",
+ "type": "string"
+ },
+ "hm_declared": {
+ "description": "True when Hazard Mitigation was declared for this area.",
+ "type": "boolean"
+ },
+ "ia_declared": {
+ "description": "True when IHP was declared for this area.",
+ "type": "boolean"
+ },
+ "pa_declared": {
+ "description": "True when Public Assistance was declared for this area.",
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "area",
+ "ia_declared",
+ "pa_declared",
+ "hm_declared"
+ ],
+ "type": "object"
+ },
+ "type": "array"
+}
changedOutput schema / properties / declarations / items / properties / pa_declared / description
Previous value: -"True when Public Assistance (infrastructure recovery grants) was declared."New value: +"True when Public Assistance (infrastructure recovery grants) was declared for any area of the declaration, also when county is set."
changedOutput schema / properties / error / properties / data / properties / reason / description
Previous value: -"Machine-readable failure mode. Declared by this tool: `invalid_state`: The state parameter is not a valid 2-letter US state/territory code. `no_results`: Query returned zero disaster declarations. Other values are possible when a failure originates below the handler."New value: +"Machine-readable failure mode. Declared by this tool: `invalid_state`: The state parameter is not a valid 2-letter US state/territory code. `invalid_range`: date_from is later than date_to, so no declaration could match. `no_results`: Query returned zero disaster declarations. `request_too_long`: The incident_type or county value makes the request URL longer than the roughly 8,900 characters OpenFEMA accepts. Other values are possible when a failure originates below the handler."
changedOutput schema / properties / error / properties / data / properties / reason / examples
Previous value: -[
- "invalid_state",
- "no_results"
-]New value: +[
+ "invalid_state",
+ "invalid_range",
+ "no_results",
+ "request_too_long"
+]
addedOutput schema / properties / next_offset
Added value: +{
+ "description": "Offset of the next page: offset plus returned_count. Present only while matching declarations remain past this page — when truncated is true, only within the declarations dated after the day the window ends. Pass it as offset to continue.",
+ "type": "number"
+}
changedOutput schema / properties / notice / description
Previous value: -"Paging guidance: when offset is at or past the end of the matching declarations, the total and the last valid offset; when truncated is true, that the totals are lower bounds and the date_to (YYYY-MM-DD) to search next for older declarations."New value: +"Paging guidance: the offset to continue from and whether limit or the response budget ended the page; when offset is at or past the end of the matching declarations, the total and the last valid offset; when truncated is true, that the totals are lower bounds and the date_to (YYYY-MM-DD) to search next for older declarations; when area_totals_unavailable is true, why the area totals could not be read."
changedOutput schema / properties / total_area_rows / description
Previous value: -"Total matching designated-area rows from the API (raw row count, not declaration count). DisasterDeclarationsSummaries returns one row per designated area per disaster, so this is always ≥ the number of unique declarations. When it exceeds 10,000, the search reads the most recent 10,000 rows and drops the declarations dated on the oldest day among them, so every returned declaration is complete; the notice names the date_to that continues with older declarations."New value: +"Total matching designated-area rows from the API (raw row count, not declaration count) — with county set, the rows of the matching areas only. DisasterDeclarationsSummaries returns one row per designated area per disaster, so this is always ≥ the number of unique declarations. When it exceeds 10,000, the search reads the most recent 10,000 rows and drops the declarations dated on the oldest day among them, so every returned declaration is complete; the notice names the date_to that continues with older declarations."