Get FEMA Housing Assistance Data
fema_get_housing_assistanceRetrieve Individual Assistance (IA) housing data for a disaster by disaster number. Returns owner and/or renter records aggregated by county, city, and ZIP code — valid registrations, total approved IHP amounts, repair/rental/other-needs amounts, and inspection counts (owners also carry inspected damage in USD). Narrow with state, county, or zip_code; owners_count, renters_count, and offset then count the filtered records. Use type to select owners, renters, or both (default). A page holds at most 100,000 characters of records, owners and renters cut at the same row count so one offset continues both; when records remain past it, next_offset is the offset to continue from. When either dataset exceeds the first inline page and DataCanvas is enabled, stage each nonempty queried dataset for SQL in fema_dataframe_query. Use disaster_number from fema_search_disasters.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"disaster_number": "<disaster_number>"
},
"name": "fema_get_housing_assistance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Which housing assistance dataset to query: owners, renters, or both (default). | both |
| limit | No | Maximum records per dataset to return (1–10000, default 100). A page also stops at 100,000 characters of owner and renter records together, cutting both datasets at the same row count; when either bound leaves matching records out, next_offset names the offset to continue from. | |
| state | No | Two-letter state code to narrow results when a disaster spans multiple states. | |
| county | No | Filter by county name (e.g., Harris, Harris County, Harris (County)). Case-insensitive substring match: bare harris also matches Harrison. Recognized terminal County, Parish, Borough, and Census Area forms match with or without parentheses, retaining the county name and type. | |
| offset | No | Pagination offset into each queried dataset (default 0). Pass the previous page’s next_offset to continue both. | |
| zip_code | No | Filter by 5-digit ZIP code, as a string with leading zeros kept (e.g., 77084, 00609). ZIP+4 is not accepted. One ZIP can return several records, one per county and city spelling. | |
| canvas_id | No | Reuse a canvas returned by an earlier call. Used only when staging from offset 0; omit to stage on a new canvas. | |
| disaster_number | Yes | FEMA disaster number. Obtain from fema_search_disasters. Numbers above 32767 match no declaration. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| notice | No | Zero-match guidance for supplied filters and declared programs, or paging guidance: the continuation offset and whether limit or the response budget ended the page, and each queried nonzero dataset’s total and last valid offset when past its end. | |
| owners | No | Homeowner (HousingAssistanceOwners) records. Empty when type is "renters" or no owner data exists. | |
| renters | No | Renter (HousingAssistanceRenters) records. Empty when type is "owners" or no renter data exists. | |
| spilled | No | True when housing records were staged on DataCanvas. | |
| canvas_id | No | Canvas ID to pass to fema_dataframe_describe and fema_dataframe_query. Present only when spilled is true. | |
| totalCount | No | Total owner + renter records available before the per-dataset limit — exceeds the returned count when either dataset was capped. | |
| next_offset | No | Offset of the next page, for both datasets: offset plus the larger of the owner and renter record counts returned. Present only while records remain in a queried dataset; pass it as offset to continue. | |
| owners_count | No | Total owner records matching the disaster and any state, county, or zip_code filter, before the per-dataset limit. | |
| canvas_tables | No | Dataset-to-table mapping: HousingAssistanceOwners holds owners and HousingAssistanceRenters holds renters. Present only when spilled is true. | |
| county_filter | No | The county name both datasets were filtered by, trimmed, matched as a case-insensitive substring. Absent when county was not set. | |
| renters_count | No | Total renter records matching the disaster and any state, county, or zip_code filter, before the per-dataset limit. | |
| zip_code_filter | No | The 5-digit ZIP code both datasets were filtered by. Absent when zip_code was not set. |