--- type: "firecrawl-provider" description: "FEMA (fema.gov): the disaster-survivor referral directories (the national list and the 56 state and territory local-level lists, including American Samoa, the Northern Mariana Islands, the U.S. Virgin Islands, Guam and Puerto Rico) with service category, entity, type of assistance and telephone numbers, parsed from the server-rendered pages; and the anonymous OpenFEMA JSON API: disaster declaration search (DisasterDeclarationsSummaries v2), one disaster's declaration record, designated areas and funding totals, the dataset catalog (with refresh cadence, deprecation successors and bulk-file hand-offs), per-dataset data dictionaries, a generic OData query over any OpenFEMA dataset, and the collection contract over any dataset version: source_status (count, newest lastRefresh, publication id, deprecation, files), records_list (full listing pinned to one publication, segmentable by field equality and calendar year), records_changes (modified-since on lastRefresh) and records_get (one record by id). Also the National Risk Index (NRI v1.20, December 2025) table downloads: release status with file sizes and ETag MD5 hashes, paginated state, county, census-tract and tribal rows (risk, expected annual loss, social vulnerability, community resilience and 18 hazard blocks) pinned to one publication, single-row lookups by FIPS, the hazard catalogue and the data dictionary." use_when: "FEMA (fema.gov): the disaster-survivor referral directories (the national list and the 56 state and territory local-level lists, including American Samoa, the Northern Mariana Islands, the U.S. Virgin Islands, Guam and Puerto Rico) with service category, entity, type of assistance and telephone numbers, parsed from the server-rendered pages; and the anonymous OpenFEMA JSON API: disaster declaration search (DisasterDeclarationsSummaries v2), one disaster's declaration record, designated areas and funding totals, the dataset catalog (with refresh cadence, deprecation successors and bulk-file hand-offs), per-dataset data dictionaries, a generic OData query over any OpenFEMA dataset, and the collection contract over any dataset version: source_status (count, newest lastRefresh, publication id, deprecation, files), records_list (full listing pinned to one publication, segmentable by field equality and calendar year), records_changes (modified-since on lastRefresh) and records_get (one record by id). Also the National Risk Index (NRI v1.20, December 2025) table downloads: release status with file sizes and ETag MD5 hashes, paginated state, county, census-tract and tribal rows (risk, expected annual loss, social vulnerability, community resilience and 18 hazard blocks) pinned to one publication, single-row lookups by FIPS, the hazard catalogue and the data dictionary." categories: "Public records" capabilities: 17 credits_per_call: 5 --- # FEMA on Firecrawl Alexandria FEMA (fema.gov): the disaster-survivor referral directories (the national list and the 56 state and territory local-level lists, including American Samoa, the Northern Mariana Islands, the U.S. Virgin Islands, Guam and Puerto Rico) with service category, entity, type of assistance and telephone numbers, parsed from the server-rendered pages; and the anonymous OpenFEMA JSON API: disaster declaration search (DisasterDeclarationsSummaries v2), one disaster's declaration record, designated areas and funding totals, the dataset catalog (with refresh cadence, deprecation successors and bulk-file hand-offs), per-dataset data dictionaries, a generic OData query over any OpenFEMA dataset, and the collection contract over any dataset version: source_status (count, newest lastRefresh, publication id, deprecation, files), records_list (full listing pinned to one publication, segmentable by field equality and calendar year), records_changes (modified-since on lastRefresh) and records_get (one record by id). Also the National Risk Index (NRI v1.20, December 2025) table downloads: release status with file sizes and ETag MD5 hashes, paginated state, county, census-tract and tribal rows (risk, expected annual loss, social vulnerability, community resilience and 18 hazard blocks) pinned to one publication, single-row lookups by FIPS, the hazard catalogue and the data dictionary. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `fema-gov` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/fema-gov) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/fema-gov/openapi.json) ## Capabilities - [Get dataset fields](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/get_dataset_fields): The data dictionary of one OpenFEMA dataset (/api/open/v1/DataSetFields filtered by entity and version): every field with its name, title, description, type, nullability, searchability and primary-key flag, in the dataset's sort order. An entity/version pair with no fields is `not_found`. - [Get disaster](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/get_disaster): One FEMA disaster by disaster number from three OpenFEMA datasets: the web-facing declaration record (FemaWebDisasterDeclarations v1: name, state, dates, region, program flags, GIS links), its designated areas with program types (FemaWebDeclarationAreas v1) and its funding totals (FemaWebDisasterSummaries v1: IHP, HA, ONA, PA, HMGP obligations; null when FEMA publishes none yet). Field names are OpenFEMA's own (camelCase). An unknown disaster number is `not_found`. - [Get local referrals](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/get_local_referrals): One state or territory local-level referral directory (/assistance/individual/disaster-survivors/state-local-referral-lists/{slug}): every row of the page's referral table with service category, entity, the entity's link when the page has one, the type of assistance, the telephone cell as written and the phone numbers parsed from it, plus the page's last-updated timestamp and Drupal node id. Rows are returned in page order; a cell the page leaves blank is null. - [Get national referrals](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/get_national_referrals): The National Referral List (/assistance/individual/disaster-survivors/national-referral-list): the service categories the list covers and every row of the national-level referral table (category, entity, link, type of assistance, telephone text and parsed phone numbers), with the page's last-updated timestamp. - [List datasets](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/list_datasets): The OpenFEMA dataset catalog (/api/open/v1/DataSets): every published dataset with its entity name, API version, title, record count, last refresh, data dictionary and landing page URLs and any deprecation notice, sorted by name; optionally narrowed to names containing a substring. `name` + `version` feed `get_dataset_fields` and `query_dataset`; each row also carries lastDataSetRefresh (reload time), accrualPeriodicity (refresh cadence), depNewURL (successor), webService, the catalogue hash and the bulk-file distribution (collection contract datasets/list). - [List referral directories](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/list_referral_directories): The State and Local Level Referral Lists index (/assistance/individual/disaster-survivors/state-local-referral-lists): the 24 disaster recovery service categories FEMA lists and every state or territory referral directory with its name, page slug and URL (56 entries, territories included). Slugs feed `get_local_referrals`. - [Nri dictionary](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_dictionary): The NRI data dictionary (NRIDataDictionary.csv, shipped inside every table zip and read from the 653 KB States zip): one row per field of the NRI layers with alias, type, length, relevant layer, metric type and version; optionally filtered by a substring of the field name. - [Nri get](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_get): One NRI row by its own id: counties by STCOFIPS or NRI_ID (30031 / C30031), states by STATEFIPS, NRI_ID or USPS code (30 / S30 / MT), tribal tables by OID_ or NRI_ID (first match, with match_count), tracts by TRACTFIPS or NRI_ID (30031000100 / T30031000100). The one-fetch tables are scanned from one zip download; a tract is found by a binary search of 64 KiB Range reads over the 634 MB CSV (about 15 reads; Connecticut tracts from one tail read), all pinned to one file MD5. - [Nri hazards](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_hazards): The NRI hazard catalogue (NRI_HazardInfo.csv, shipped inside every table zip and read from the 653 KB States zip): the 18 hazards with their four-letter column prefixes (AVLN, CFLD, CWAV, DRGT, ERQK, HAIL, HWAV, HRCN, ISTM, IFLD, LNDS, LTNG, SWND, TRND, TSUN, VLCN, WFIR, WNTW), period of record, frequency model and which expected-annual-loss components apply. - [Nri list](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_list): Rows of one NRI table as records pinned to a publication. states, counties, tribal_counties and tribal_tracts are one zip fetch per page (653 KB to 26.6 MB) with an optional state filter and `limit`/`cursor` row paging; tracts (634 MB) are read by byte range, one Range request of `page_bytes` per page cut at the last row boundary, cursor = publication MD5 + next byte offset. Any page whose file MD5 differs from the cursor's fails with invalid_input `publication_changed`. - [Nri status](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_status): National Risk Index (NRI) release check: for each table zip under /about/reports-and-data/openfema/nri// its URL, size, ETag (whose first segment is the file MD5), Last-Modified, CSV layout and the NRI_VER label, from a 24 KiB Range read per file. No record counts (they need a full read; nri_list reports total_rows). - [Query dataset](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/query_dataset): Generic OData query over any OpenFEMA dataset (/api/open/v{version}/{entity}): raw `$filter`, `$select` and `$orderby` with `$top`/`$skip` paging and the server's total count. Records are returned as OpenFEMA sends them (open objects; see `get_dataset_fields` for the field list). An unknown entity or version is `not_found`; a filter the OData parser rejects (code OF_OQP_*) is `invalid_input` with the server's message; the large datasets (IHP registrations, PA funded projects) share a bucket of 2 requests per 60 seconds and answer `upstream_rate_limited` beyond it. - [Records changes](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/records_changes): Records of one OpenFEMA dataset version refreshed since an instant (collection contract `records/changes`): the publisher's own modified-since filter `$filter=lastRefresh gt ''`, paged with `$orderby=id` and pinned to the publication like `records_list` (same cursor, same `publication_changed` rule). Only UPDATE datasets carry a per-record `lastRefresh` (DisasterDeclarationsSummaries v2, FemaWebDisasterDeclarations v1, IpawsArchivedAlerts v1, ...); for RELOAD datasets (NfipClaims v3, NfipPolicies v3, HmaSubapplications v2) OpenFEMA offers no delta and the call fails with `invalid_input` code `no_change_feed`: list snapshots and diff them downstream. Deletions are never signalled by OpenFEMA (`deletions_signalled` is always false); a row that disappears is only visible as a count drop in `source_status`. - [Records get](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/records_get): One OpenFEMA record by the source's own `id` (collection contract `records/get`): GET /api/open/v{version}/{dataset}/{id}, the row as sent plus `source_record_id`, `source_url`, `publication_id` (from the status query) and `retrieved_at`. Ids are UUIDs (declarations, HMA, IPAWS) or integers (NFIP v3); an unknown id, dataset or version is `not_found`; an id of the wrong type for the dataset is `invalid_input`. - [Records list](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/records_list): Full listing of one OpenFEMA dataset version (collection contract `records/list`): pages of `$orderby=id&$top=&$skip=`, 1 to 5,000 rows a page (1,000 default; 1,000 declaration rows are 0.9 MB, 1,000 NFIP rows 2.4 MB). Every page re-runs the status query and compares the live `publication_id` with the one pinned in the cursor; when the dataset was refreshed in between the call fails with `invalid_input` code `publication_changed` and the listing restarts, so two publications are never mixed. Records are OpenFEMA's rows as sent (every field; declarations carry femaDeclarationString, disasterNumber, declarationType, declarationDate, incidentType, designatedArea, fipsStateCode, fipsCountyCode, placeCode, the four program flags, lastRefresh, hash, id; NFIP claims dateOfLoss, yearOfLoss, causeOfDamage, floodEvent, ratedFloodZone, waterDepth, the paid amounts, state, countyCode, censusGeoid, latitude, longitude, id) plus `source_record_id` (`:v:`), `source_url`, `publication_id` and `retrieved_at`. Segment key for datasets over ~500k rows: `segment_field`/`segment_value` (an equality, e.g. `state` = `TX` for NfipClaims v3: 394k rows) and `year_field`/`year` (one calendar year of a date field, e.g. `dateOfLoss` 2017 with `state` = `TX` for NfipClaims v3). Datasets over 20M rows (NfipPolicies v3: 74.7M) are refused with `invalid_input` code `hand_off`: OpenFEMA cannot serve an ordered page of them within the timeout, so take the parquet/csv files `source_status` lists. `$count=true` is sent on the first page only. A frozen deprecated dataset (rows empty, count positive) is `upstream_error` naming the successor. - [Search disaster declarations](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/search_disaster_declarations): OpenFEMA DisasterDeclarationsSummaries v2 (/api/open/v2/DisasterDeclarationsSummaries): one row per declared disaster and designated area, filtered by state or territory code, declaration type, incident type, disaster number and declaration date window, newest declaration first. Field names are OpenFEMA's own (camelCase). `total` is the server's count for the filter; `limit` + `skip` page through it and `next_skip` is null when exhausted. A filter that matches nothing is a successful empty result. - [Source status](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/source_status): Cheap version check of one OpenFEMA dataset version (collection contract `source/status`): the live row count (`$count=true&$top=1`), the newest per-record `lastRefresh` (`$orderby=lastRefresh desc`; null on RELOAD datasets such as NfipClaims v3 and NfipPolicies v3, whose catalogue `lastDataSetRefresh` then stands in as `published_at`), the deprecation block (`metadata.DeprecationInformation` or the catalogue's depDate/depNewURL: a deprecated dataset names its successor) and the catalogue row from /api/open/v1/DataSets with refresh cadence (`accrual_periodicity`), the catalogue's own SHA-1 `hash` and the bulk file hand-offs (`files`: csv/json/jsonl/parquet URLs with FEMA's size class; FEMA posts no per-file hash or byte size). `publication_id` = `:v::` is the pin `records_list` cursors carry. An unknown dataset or version is `not_found`. ## 1. Choose this provider when FEMA (fema.gov): the disaster-survivor referral directories (the national list and the 56 state and territory local-level lists, including American Samoa, the Northern Mariana Islands, the U.S. Virgin Islands, Guam and Puerto Rico) with service category, entity, type of assistance and telephone numbers, parsed from the server-rendered pages; and the anonymous OpenFEMA JSON API: disaster declaration search (DisasterDeclarationsSummaries v2), one disaster's declaration record, designated areas and funding totals, the dataset catalog (with refresh cadence, deprecation successors and bulk-file hand-offs), per-dataset data dictionaries, a generic OData query over any OpenFEMA dataset, and the collection contract over any dataset version: source_status (count, newest lastRefresh, publication id, deprecation, files), records_list (full listing pinned to one publication, segmentable by field equality and calendar year), records_changes (modified-since on lastRefresh) and records_get (one record by id). Also the National Risk Index (NRI v1.20, December 2025) table downloads: release status with file sizes and ETag MD5 hashes, paginated state, county, census-tract and tribal rows (risk, expected annual loss, social vulnerability, community resilience and 18 hazard blocks) pinned to one publication, single-row lookups by FIPS, the hazard catalogue and the data dictionary. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "fema-gov", "capability": "us-disaster-assistance/get_dataset_fields", "options": { "entity": "DisasterDeclarationsSummaries", "version": 2 } } ``` ## 3. Add provider options Use only the options needed for the task: - `entity` (string, required): Dataset entity name from `list_datasets`, e.g. `DisasterDeclarationsSummaries`. Pattern: ^[A-Za-z][A-Za-z0-9]*$. Example: `list_datasets` - `version` (number, required): Dataset version from `list_datasets`, e.g. 2. Example: `10` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "fema-gov", capability: "us-disaster-assistance/get_dataset_fields", options: { entity: "DisasterDeclarationsSummaries", version: 2, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "fema-gov", "capability": "us-disaster-assistance/get_dataset_fields", "options": { "entity": "DisasterDeclarationsSummaries", "version": 2 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "fema-gov", "capability": "us-disaster-assistance/get_dataset_fields", "options": { "entity": "DisasterDeclarationsSummaries", "version": 2 } } }' ``` ### CLI ```sh firecrawl scrape 'fema-gov/us-disaster-assistance/get_dataset_fields' \ --options '{"entity":"DisasterDeclarationsSummaries","version":2}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "fema-gov", "capability": "us-disaster-assistance/get_dataset_fields", "options": { "entity": "DisasterDeclarationsSummaries", "version": 2 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "fema-gov", "capability": "us-disaster-assistance/get_dataset_fields", "options": { "entity": "DisasterDeclarationsSummaries", "version": 2 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "dataset_id": "openfema-47", "entity": "DisasterDeclarationsSummaries", "field_count": 29, "fields": [ { "description": "Agency standard method for uniquely identifying Stafford Act declarations - Concatenation of declaration type, disaster number and state code. Ex: DR-4393-NC", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "femaDeclarationString", "primaryKey": false, "sortOrder": 1, "title": "FEMA Declaration String", "type": "text" }, { "description": "Sequentially assigned number used to designate an event or incident declared as a disaster. For more information on the disaster process, please visit https://www.fema.gov/disasters/how-declared", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "disasterNumber", "primaryKey": true, "sortOrder": 2, "title": "Disaster Number", "type": "smallint" }, { "description": "The name or phrase describing the U.S. state, district, or territory", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "state", "primaryKey": false, "sortOrder": 3, "title": "State", "type": "text" }, { "description": "Two character code that defines if this is a major disaster, fire management, or emergency declaration. For more information on the disaster process, please visit https://www.fema.gov/disasters/how-declared", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "declarationType", "primaryKey": false, "sortOrder": 4, "title": "Declaration Type", "type": "text" }, { "description": "Date the disaster was declared", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "declarationDate", "primaryKey": false, "sortOrder": 5, "title": "Declaration Date", "type": "date" }, { "description": "Fiscal year in which the disaster was declared", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "fyDeclared", "primaryKey": false, "sortOrder": 6, "title": "FY Declared", "type": "smallint" }, { "description": "The primary or official type of incident such as fire or flood. Secondary incident types may have been designated. See the designatedIncidentTypes field. For more information on incident types, please visit https://www.fema.gov/disasters/how-declared.", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "incidentType", "primaryKey": false, "sortOrder": 7, "title": "Incident Type", "type": "text" }, { "description": "Title for the disaster", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "declarationTitle", "primaryKey": false, "sortOrder": 8, "title": "Declaration Title", "type": "text" }, { "description": "Denotes whether the Individuals and Households program was declared for this disaster. For more information on the program, please visit https://www.fema.gov/assistance/individual/program. To determine which FEMA events have been authorized to receive Individual Assistance, use both ihProgramDeclared and iaProgramDeclared. For more information see https://www.fema.gov/about/openfema/faq", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "ihProgramDeclared", "primaryKey": false, "sortOrder": 9, "title": "IH Program Declared", "type": "boolean" }, { "description": "Denotes whether the Individual Assistance program was declared for this disaster. For more information on the program, please visit https://www.fema.gov/assistance/individual/program. To determine which FEMA events have been authorized to receive Individual Assistance, use both ihProgramDeclared and iaProgramDeclared. For more information see https://www.fema.gov/about/openfema/faq", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "iaProgramDeclared", "primaryKey": false, "sortOrder": 10, "title": "IA Program Declared", "type": "boolean" }, { "description": "Denotes whether the Public Assistance program was declared for this disaster. For more information on the program, please visit https://www.fema.gov/assistance/public/program-overview", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "paProgramDeclared", "primaryKey": false, "sortOrder": 11, "title": "PA Program Declared", "type": "boolean" }, { "description": "Denotes whether the Hazard Mitigation program was declared for this disaster. For more information on the program, please visit https://www.fema.gov/grants/mitigation/hazard-mitigation", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "hmProgramDeclared", "primaryKey": false, "sortOrder": 12, "title": "HM Program Declared", "type": "boolean" }, { "description": "Date the incident itself began", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "incidentBeginDate", "primaryKey": false, "sortOrder": 13, "title": "Incident Begin Date", "type": "date" }, { "description": "Date the incident itself ended", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "incidentEndDate", "primaryKey": false, "sortOrder": 14, "title": "Incident End Date", "type": "date" }, { "description": "Date all financial transactions for all programs are completed", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "disasterCloseoutDate", "primaryKey": false, "sortOrder": 15, "title": "Disaster Closeout Date", "type": "date" }, { "description": "Denotes that a declaration request was submitted directly to the President, independently of a state, by a Tribal Nation.", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "tribalRequest", "primaryKey": false, "sortOrder": 16, "title": "Tribal Request", "type": "boolean" }, { "description": "FIPS two-digit numeric code used to identify the United States, the District of Columbia, US territories, outlying areas of the US and freely associated states", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "fipsStateCode", "primaryKey": false, "sortOrder": 17, "title": "FIPS State Code", "type": "text" }, { "description": "FIPS three-digit numeric code used to identify counties and county equivalents in the United States, the District of Columbia, US territories, outlying areas of the US and freely associated states. Please note that Indian Reservations are not counties and thus will not have a FIPS county code, please utilize the placeCode field instead. If the designation is made for the entire state, this value will be 000 as multiple (all) counties cannot be entered.", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "fipsCountyCode", "primaryKey": false, "sortOrder": 18, "title": "FIPS County Code", "type": "text" }, { "description": "A unique code system FEMA uses internally to recognize locations that takes the numbers '99' + the 3-digit county FIPS code. There are some declared locations that dont have recognized FIPS county codes in which case we assigned a unique identifier", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "placeCode", "primaryKey": true, "sortOrder": 19, "title": "Place Code", "type": "text" }, { "description": "The name or phrase describing the geographic area that was included in the declaration", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "designatedArea", "primaryKey": false, "sortOrder": 20, "title": "Designated Area", "type": "text" }, { "description": "Number assigned to the declaration request", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "declarationRequestNumber", "primaryKey": false, "sortOrder": 21, "title": "Declaration Request Number", "type": "text" }, { "description": "The date when the declaration request was made", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "declarationRequestDate", "primaryKey": false, "sortOrder": 22, "title": "Declaration Request Date", "type": "date" }, { "description": "Last date when IA requests can be filed. Data available after 1998 only. The date only applies if IA has been approved for the disaster.", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "lastIAFilingDate", "primaryKey": false, "sortOrder": 23, "title": "Last IA Filing Date", "type": "date" }, { "description": "Unique identifier for an incident. Incidents are events that may or may not become declared disasters.", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "incidentId", "primaryKey": false, "sortOrder": 24, "title": "Incident Identifier", "type": "text" }, { "description": "Number (1-10) used to represent the FEMA region where the disaster occurred.", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "region", "primaryKey": false, "sortOrder": 25, "title": "Region", "type": "smallint" }, { "description": "A comma-separated list of incident types designated for the disaster. The primary incident type is described in the incidentType field. Codes are: 0: Not applicable; 1: Explosion; 2: Straight-Line Winds; 3: Tidal Wave; 4: Tropical Storm; 5: Winter Storm; 8: Tropical Depression; A: Tsunami; B: Biological; C: Coastal Storm; D: Drought; E: Earthquake; F: Flood; G: Freezing; H: Hurricane; I: Terrorist; J: Typhoon; K: Dam/Levee Break; L: Chemical; M: Mud/Landslide; N: Nuclear; O: Severe Ice Storm; P: Fishing Losses; Q: Crop Losses; R: Fire; S: Snowstorm; T: Tornado; U: Civil Unrest; V: Volcanic Eruption; W: Severe Storm; X: Toxic Substances; Y: Human Cause; Z: Other", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "designatedIncidentTypes", "primaryKey": false, "sortOrder": 26, "title": "Declared Incident types", "type": "text" }, { "description": "Date the record was last updated in the API data store", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "lastRefresh", "primaryKey": false, "sortOrder": 27, "title": "Last Refresh", "type": "datetimez" }, { "description": "MD5 Hash of the fields and values of the record", "isNestedObject": false, "isNullable": false, "isSearchable": false, "name": "hash", "primaryKey": false, "sortOrder": 28, "title": "Hash", "type": "text" }, { "description": "Unique ID assigned to the record", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "id", "primaryKey": false, "sortOrder": 29, "title": "ID", "type": "uuid" } ], "observed_at_ms": 1790463926693, "source_url": "https://www.fema.gov/api/open/v1/DataSetFields?$filter=openFemaDataSet%20eq%20%27DisasterDeclarationsSummaries%27%20and%20datasetVersion%20eq%202&$orderby=sortOrder%20asc&$top=1000&$count=true", "version": 2 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get dataset fields - Capability: `us-disaster-assistance/get_dataset_fields` - Description: The data dictionary of one OpenFEMA dataset (/api/open/v1/DataSetFields filtered by entity and version): every field with its name, title, description, type, nullability, searchability and primary-key flag, in the dataset's sort order. An entity/version pair with no fields is `not_found`. - Instructions: Learn the exact field names and types of a dataset before writing a `query_dataset` filter (field names differ per dataset: `state` vs `stateCode` vs `damagedStateAbbreviation`). - Cost: 5 credits per call - Capability file: [Get dataset fields](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/get_dataset_fields) Accepted options: - `entity` (string, required): Dataset entity name from `list_datasets`, e.g. `DisasterDeclarationsSummaries`. Pattern: ^[A-Za-z][A-Za-z0-9]*$. Example: `list_datasets` - `version` (number, required): Dataset version from `list_datasets`, e.g. 2. Example: `10` Response schema example: ```json { "dataset_id": "openfema-47", "entity": "DisasterDeclarationsSummaries", "field_count": 29, "fields": [ { "description": "Agency standard method for uniquely identifying Stafford Act declarations - Concatenation of declaration type, disaster number and state code. Ex: DR-4393-NC", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "femaDeclarationString", "primaryKey": false, "sortOrder": 1, "title": "FEMA Declaration String", "type": "text" }, { "description": "Sequentially assigned number used to designate an event or incident declared as a disaster. For more information on the disaster process, please visit https://www.fema.gov/disasters/how-declared", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "disasterNumber", "primaryKey": true, "sortOrder": 2, "title": "Disaster Number", "type": "smallint" }, { "description": "The name or phrase describing the U.S. state, district, or territory", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "state", "primaryKey": false, "sortOrder": 3, "title": "State", "type": "text" }, { "description": "Two character code that defines if this is a major disaster, fire management, or emergency declaration. For more information on the disaster process, please visit https://www.fema.gov/disasters/how-declared", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "declarationType", "primaryKey": false, "sortOrder": 4, "title": "Declaration Type", "type": "text" }, { "description": "Date the disaster was declared", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "declarationDate", "primaryKey": false, "sortOrder": 5, "title": "Declaration Date", "type": "date" }, { "description": "Fiscal year in which the disaster was declared", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "fyDeclared", "primaryKey": false, "sortOrder": 6, "title": "FY Declared", "type": "smallint" }, { "description": "The primary or official type of incident such as fire or flood. Secondary incident types may have been designated. See the designatedIncidentTypes field. For more information on incident types, please visit https://www.fema.gov/disasters/how-declared.", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "incidentType", "primaryKey": false, "sortOrder": 7, "title": "Incident Type", "type": "text" }, { "description": "Title for the disaster", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "declarationTitle", "primaryKey": false, "sortOrder": 8, "title": "Declaration Title", "type": "text" }, { "description": "Denotes whether the Individuals and Households program was declared for this disaster. For more information on the program, please visit https://www.fema.gov/assistance/individual/program. To determine which FEMA events have been authorized to receive Individual Assistance, use both ihProgramDeclared and iaProgramDeclared. For more information see https://www.fema.gov/about/openfema/faq", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "ihProgramDeclared", "primaryKey": false, "sortOrder": 9, "title": "IH Program Declared", "type": "boolean" }, { "description": "Denotes whether the Individual Assistance program was declared for this disaster. For more information on the program, please visit https://www.fema.gov/assistance/individual/program. To determine which FEMA events have been authorized to receive Individual Assistance, use both ihProgramDeclared and iaProgramDeclared. For more information see https://www.fema.gov/about/openfema/faq", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "iaProgramDeclared", "primaryKey": false, "sortOrder": 10, "title": "IA Program Declared", "type": "boolean" }, { "description": "Denotes whether the Public Assistance program was declared for this disaster. For more information on the program, please visit https://www.fema.gov/assistance/public/program-overview", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "paProgramDeclared", "primaryKey": false, "sortOrder": 11, "title": "PA Program Declared", "type": "boolean" }, { "description": "Denotes whether the Hazard Mitigation program was declared for this disaster. For more information on the program, please visit https://www.fema.gov/grants/mitigation/hazard-mitigation", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "hmProgramDeclared", "primaryKey": false, "sortOrder": 12, "title": "HM Program Declared", "type": "boolean" }, { "description": "Date the incident itself began", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "incidentBeginDate", "primaryKey": false, "sortOrder": 13, "title": "Incident Begin Date", "type": "date" }, { "description": "Date the incident itself ended", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "incidentEndDate", "primaryKey": false, "sortOrder": 14, "title": "Incident End Date", "type": "date" }, { "description": "Date all financial transactions for all programs are completed", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "disasterCloseoutDate", "primaryKey": false, "sortOrder": 15, "title": "Disaster Closeout Date", "type": "date" }, { "description": "Denotes that a declaration request was submitted directly to the President, independently of a state, by a Tribal Nation.", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "tribalRequest", "primaryKey": false, "sortOrder": 16, "title": "Tribal Request", "type": "boolean" }, { "description": "FIPS two-digit numeric code used to identify the United States, the District of Columbia, US territories, outlying areas of the US and freely associated states", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "fipsStateCode", "primaryKey": false, "sortOrder": 17, "title": "FIPS State Code", "type": "text" }, { "description": "FIPS three-digit numeric code used to identify counties and county equivalents in the United States, the District of Columbia, US territories, outlying areas of the US and freely associated states. Please note that Indian Reservations are not counties and thus will not have a FIPS county code, please utilize the placeCode field instead. If the designation is made for the entire state, this value will be 000 as multiple (all) counties cannot be entered.", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "fipsCountyCode", "primaryKey": false, "sortOrder": 18, "title": "FIPS County Code", "type": "text" }, { "description": "A unique code system FEMA uses internally to recognize locations that takes the numbers '99' + the 3-digit county FIPS code. There are some declared locations that dont have recognized FIPS county codes in which case we assigned a unique identifier", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "placeCode", "primaryKey": true, "sortOrder": 19, "title": "Place Code", "type": "text" }, { "description": "The name or phrase describing the geographic area that was included in the declaration", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "designatedArea", "primaryKey": false, "sortOrder": 20, "title": "Designated Area", "type": "text" }, { "description": "Number assigned to the declaration request", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "declarationRequestNumber", "primaryKey": false, "sortOrder": 21, "title": "Declaration Request Number", "type": "text" }, { "description": "The date when the declaration request was made", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "declarationRequestDate", "primaryKey": false, "sortOrder": 22, "title": "Declaration Request Date", "type": "date" }, { "description": "Last date when IA requests can be filed. Data available after 1998 only. The date only applies if IA has been approved for the disaster.", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "lastIAFilingDate", "primaryKey": false, "sortOrder": 23, "title": "Last IA Filing Date", "type": "date" }, { "description": "Unique identifier for an incident. Incidents are events that may or may not become declared disasters.", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "incidentId", "primaryKey": false, "sortOrder": 24, "title": "Incident Identifier", "type": "text" }, { "description": "Number (1-10) used to represent the FEMA region where the disaster occurred.", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "region", "primaryKey": false, "sortOrder": 25, "title": "Region", "type": "smallint" }, { "description": "A comma-separated list of incident types designated for the disaster. The primary incident type is described in the incidentType field. Codes are: 0: Not applicable; 1: Explosion; 2: Straight-Line Winds; 3: Tidal Wave; 4: Tropical Storm; 5: Winter Storm; 8: Tropical Depression; A: Tsunami; B: Biological; C: Coastal Storm; D: Drought; E: Earthquake; F: Flood; G: Freezing; H: Hurricane; I: Terrorist; J: Typhoon; K: Dam/Levee Break; L: Chemical; M: Mud/Landslide; N: Nuclear; O: Severe Ice Storm; P: Fishing Losses; Q: Crop Losses; R: Fire; S: Snowstorm; T: Tornado; U: Civil Unrest; V: Volcanic Eruption; W: Severe Storm; X: Toxic Substances; Y: Human Cause; Z: Other", "isNestedObject": false, "isNullable": true, "isSearchable": true, "name": "designatedIncidentTypes", "primaryKey": false, "sortOrder": 26, "title": "Declared Incident types", "type": "text" }, { "description": "Date the record was last updated in the API data store", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "lastRefresh", "primaryKey": false, "sortOrder": 27, "title": "Last Refresh", "type": "datetimez" }, { "description": "MD5 Hash of the fields and values of the record", "isNestedObject": false, "isNullable": false, "isSearchable": false, "name": "hash", "primaryKey": false, "sortOrder": 28, "title": "Hash", "type": "text" }, { "description": "Unique ID assigned to the record", "isNestedObject": false, "isNullable": false, "isSearchable": true, "name": "id", "primaryKey": false, "sortOrder": 29, "title": "ID", "type": "uuid" } ], "observed_at_ms": 1790463926693, "source_url": "https://www.fema.gov/api/open/v1/DataSetFields?$filter=openFemaDataSet%20eq%20%27DisasterDeclarationsSummaries%27%20and%20datasetVersion%20eq%202&$orderby=sortOrder%20asc&$top=1000&$count=true", "version": 2 } ``` ### Get disaster - Capability: `us-disaster-assistance/get_disaster` - Description: One FEMA disaster by disaster number from three OpenFEMA datasets: the web-facing declaration record (FemaWebDisasterDeclarations v1: name, state, dates, region, program flags, GIS links), its designated areas with program types (FemaWebDeclarationAreas v1) and its funding totals (FemaWebDisasterSummaries v1: IHP, HA, ONA, PA, HMGP obligations; null when FEMA publishes none yet). Field names are OpenFEMA's own (camelCase). An unknown disaster number is `not_found`. - Instructions: Read one disaster's declaration details, designated areas and assistance totals after finding its number with `search_disaster_declarations`. - Cost: 5 credits per call - Capability file: [Get disaster](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/get_disaster) Accepted options: - `disaster_number` (number, required): FEMA disaster number, e.g. 4931 (DR-4931-MP). Example: `10` Response schema example: ```json { "declaration": { "closeoutDate": null, "declarationDate": "2022-09-15T00:00:00.000Z", "declarationRequestDate": "2022-08-12T00:00:00.000Z", "declarationType": "Major Disaster", "designatedIncidentTypes": null, "disasterName": "HIGH SURF, HIGH WINDS, AND FLOODING", "disasterNumber": 4669, "disasterPageUrl": "https://www.fema.gov/disaster/4669", "entryDate": "2022-09-16T00:00:00.000Z", "geoJsonUrl": "https://gis.fema.gov/geoserver/FEMA/ows?service=WFS&version=1.0.0&request=GetFeature&typeName=FEMA%3ACURRENT_DISASTER_DECLARATIONS&maxFeatures=500&outputFormat=application%2Fjson&CQL_FILTER=dec_number%3D%27DR-4669%27", "hmProgramDeclared": true, "iaProgramDeclared": false, "id": "c08b4981-be98-44fa-b738-d1577122c6f7", "ihProgramDeclared": false, "incidentBeginDate": "2022-07-12T00:00:00.000Z", "incidentEndDate": "2022-07-15T00:00:00.000Z", "incidentType": "Severe Storm", "kmzfileUrl": "https://gis.fema.gov/maps/dec_4669.kmz", "lastRefresh": "2026-08-18T14:37:57.870Z", "paProgramDeclared": true, "region": 9, "shapefileUrl": "https://gis.fema.gov/maps/dec_4669.zip", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" }, "designated_area_count": 9, "designated_areas": [ { "closeoutDate": null, "designatedDate": "2022-09-15T00:00:00.000Z", "entryDate": "2022-09-16T00:00:00.000Z", "id": "097a01ca-0d89-434e-b154-0485a5af26c0", "placeCode": "0", "placeName": "Statewide", "programTypeCode": "HM", "programTypeDescription": "HM - Hazard Mitigation", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" }, { "closeoutDate": null, "designatedDate": "2022-09-15T00:00:00.000Z", "entryDate": "2022-09-16T00:00:00.000Z", "id": "76861568-423b-4597-9062-e6c687712584", "placeCode": "0", "placeName": "Statewide", "programTypeCode": "PA", "programTypeDescription": "PA - Public Assistance", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" }, { "closeoutDate": null, "designatedDate": "2022-09-15T00:00:00.000Z", "entryDate": "2022-09-16T00:00:00.000Z", "id": "7b724872-de35-43a9-ae0b-a2f5a1afa943", "placeCode": "0", "placeName": "Statewide", "programTypeCode": "PA-A", "programTypeDescription": "PA-A - Debris Removal", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" }, { "closeoutDate": null, "designatedDate": "2022-09-15T00:00:00.000Z", "entryDate": "2022-09-16T00:00:00.000Z", "id": "c561ab7b-2e31-4443-b836-1bf4c9348e50", "placeCode": "0", "placeName": "Statewide", "programTypeCode": "PA-B", "programTypeDescription": "PA-B - Protective Measures", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" }, { "closeoutDate": null, "designatedDate": "2022-09-15T00:00:00.000Z", "entryDate": "2022-09-16T00:00:00.000Z", "id": "685952fb-b273-4a7e-a4b0-0aa78d86dfb3", "placeCode": "0", "placeName": "Statewide", "programTypeCode": "PA-C", "programTypeDescription": "PA-C - Roads & Bridges", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" }, { "closeoutDate": null, "designatedDate": "2022-09-15T00:00:00.000Z", "entryDate": "2022-09-16T00:00:00.000Z", "id": "252d123c-16bc-41ae-b45d-93c380d1f5a2", "placeCode": "0", "placeName": "Statewide", "programTypeCode": "PA-D", "programTypeDescription": "PA-D - Water Control Facilities", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" }, { "closeoutDate": null, "designatedDate": "2022-09-15T00:00:00.000Z", "entryDate": "2022-09-16T00:00:00.000Z", "id": "5400b940-b3d3-439e-8c82-c50f7bc114a4", "placeCode": "0", "placeName": "Statewide", "programTypeCode": "PA-E", "programTypeDescription": "PA-E - Public Buildings", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" }, { "closeoutDate": null, "designatedDate": "2022-09-15T00:00:00.000Z", "entryDate": "2022-09-16T00:00:00.000Z", "id": "b5d50feb-6f2a-45c8-bfc2-255e97642e4a", "placeCode": "0", "placeName": "Statewide", "programTypeCode": "PA-F", "programTypeDescription": "PA-F - Public Utilities", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" }, { "closeoutDate": null, "designatedDate": "2022-09-15T00:00:00.000Z", "entryDate": "2022-09-16T00:00:00.000Z", "id": "37787b56-327a-48eb-9781-a92f4c321c03", "placeCode": "0", "placeName": "Statewide", "programTypeCode": "PA-G", "programTypeDescription": "PA-G - Recreational or Other", "stateCode": "AS", "stateName": "American Samoa", "updateDate": "2022-09-16T00:00:00.000Z" } ], "disaster_number": 4669, "disaster_url": "https://www.fema.gov/disaster/4669", "funding": { "iaLoadDate": null, "id": "da1f49d4-90ff-45a0-8675-bbfb4cdfabfd", "lastRefresh": "2026-09-17T09:30:07.023Z", "paLoadDate": "2026-05-17T00:00:00.000Z", "totalAmountHaApproved": null, "totalAmountIhpApproved": null, "totalAmountOnaApproved": null, "totalNumberIaApproved": null, "totalObligatedAmountCatAb": 273449.67, "totalObligatedAmountCatC2g": 994829.97, "totalObligatedAmountHmgp": 13245.84, "totalObligatedAmountPa": 1273951.56 }, "observed_at_ms": 1790463918217, "sources": [ "https://www.fema.gov/api/open/v1/FemaWebDisasterDeclarations?$filter=disasterNumber%20eq%204669&$top=5&$count=true", "https://www.fema.gov/api/open/v1/FemaWebDeclarationAreas?$filter=disasterNumber%20eq%204669&$orderby=placeName%20asc%2CprogramTypeCode%20asc&$top=1000&$count=true", "https://www.fema.gov/api/open/v1/FemaWebDisasterSummaries?$filter=disasterNumber%20eq%204669&$top=5&$count=true" ] } ``` ### Get local referrals - Capability: `us-disaster-assistance/get_local_referrals` - Description: One state or territory local-level referral directory (/assistance/individual/disaster-survivors/state-local-referral-lists/{slug}): every row of the page's referral table with service category, entity, the entity's link when the page has one, the type of assistance, the telephone cell as written and the phone numbers parsed from it, plus the page's last-updated timestamp and Drupal node id. Rows are returned in page order; a cell the page leaves blank is null. - Instructions: Find local disaster recovery contacts (aging services, crisis counseling, housing, legal aid, ...) for a specific state or territory such as `american-samoa`, `commonwealth-northern-mariana-islands` or `virgin-islands`. - Cost: 5 credits per call - Capability file: [Get local referrals](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/get_local_referrals) Accepted options: - `category_contains` (string): Optional case-insensitive substring filter on the Category cell, e.g. `Housing`, `Crisis`, `Legal`. Without it every row is returned. Example: `` - `slug` (string): Directory page slug from `list_referral_directories`, e.g. `american-samoa`, `commonwealth-northern-mariana-islands`, `virgin-islands`, `guam`, `puerto-rico`, `texas`. Pattern: ^[a-z0-9][a-z0-9-]*$. Example: `list_referral_directories` - `url` (string): Alternative to `slug`: a pasted fema.gov referral directory URL. Example: `` Response schema example: ```json { "category_filter": null, "entries": [ { "category": "Access and Functional Needs and Disabilities", "entity": "Office of Vocational Rehabilitation", "entity_url": null, "phones": [ "684-699-1372" ], "telephone": "684-699-1372", "type_of_assistance": "Career counseling, job training and help with your job search. Your state VR office may also be able to help provide assistive technology, personal assistance services, transportation and the tools or equipment" }, { "category": "Aging Services", "entity": "American Samoa Government Departments", "entity_url": null, "phones": [ "684-699-2531" ], "telephone": "684-699-2531", "type_of_assistance": "Resources and information for seniors" }, { "category": "Agricultural Aid", "entity": "American Samoa Government Department of Agriculture", "entity_url": "https://www.nasda.org/organizations/american-samoa-department-of-agriculture", "phones": [ "684-699-9272" ], "telephone": "684-699-9272", "type_of_assistance": "Resources and information for agriculture in American Samoa" }, { "category": "Animals/Pets", "entity": "American Samoa Department of Marine & Wildlife Resources", "entity_url": null, "phones": [ "684-633-4456" ], "telephone": "684-633-4456", "type_of_assistance": "Information for fisheries and marine life" }, { "category": "Citizenship", "entity": "American Samoa Department of Legal Affairs: Immigration Office", "entity_url": null, "phones": [ "684-633-0135", "684-633-1885" ], "telephone": "684-633-0135 or 684-633-1885", "type_of_assistance": "Immigration Office ensures lawful entry of all travelers into and out of the Territory. Entry Permits, OK Boards, Residency Petitions, and applications" }, { "category": "Consumer Services", "entity": "American Samoa Department of Legal Affairs: Consumer Protection", "entity_url": null, "phones": [ "684-633-4163" ], "telephone": "684-633-4163", "type_of_assistance": "Monitoring business practices in American Samoa and to safeguard consumer rights. Downloadable form for consumer complaints, online directory of attorneys." }, { "category": "Contractors", "entity": "American Samoa Department of Commerce", "entity_url": null, "phones": [ "684-633-5155" ], "telephone": "684-633-5155", "type_of_assistance": "Access local permitting or business requirements, land use permits and business forms." }, { "category": "Crisis Counseling", "entity": "Salvation Army Hawaiian and Pacific Islands", "entity_url": "https://hawaii.salvationarmy.org/hawaii/fts", "phones": [ "911", "808-732-2802" ], "telephone": "Emergency: 911; 808-732-2802", "type_of_assistance": "Family Treatment Services offers a continuum of care for women wanting help with their alcohol/drug addiction. The Hawaiian and Pacific Islands Division of The Salvation Army covers the state of Hawaii and the Pacific Islands including Guam, Republic of the Marshall Islands and The Federated States of Micronesia." }, { "category": "Disaster Unemployment Assistance", "entity": "American Samoa Government Human Resources Department", "entity_url": "https://www.commonwealthofnations.org/organisations/american_samoa_government_human_resources_department/", "phones": [ "684-633-4485" ], "telephone": "684-633-4485", "type_of_assistance": "The Department of Human Resources Employment Training Division administers the federal disaster-benefits program in American Samoa for the U.S Department of Labor, Employment & Training Administration, on behalf of FEMA. The department offers reemployment services, including testing, counseling and job placement." }, { "category": "Environment", "entity": "American Samoa Environmental Protection Agency", "entity_url": "https://www.epa.as.gov/", "phones": [ "684-733-6149", "684-633-2304" ], "telephone": "24 hour emergency: 684-733-6149; Office: 684-633-2304; Online contact form", "type_of_assistance": "Developing, implementing and enforcing environmental laws that regulate air, water and soil quality, pesticide use and waste recycling and reduction. Beach advisory, land use permits, and water supply permit." }, { "category": "Essential Needs", "entity": "Department of Human and Social Services", "entity_url": null, "phones": [ "684 633-7506", "684-633-7720" ], "telephone": "684 633-7506 or 684-633-7720", "type_of_assistance": "Nutrition programs" }, { "category": "Family & Protective Services", "entity": "American Samoa: Financial Assistance For Families | Childcare.gov", "entity_url": "https://childcare.gov/state-resources?state=115&type=202", "phones": [ "684-633-1571", "684-633-1572", "684-633-1573" ], "telephone": "684-633-1571 or 684-633-1572 or 684-633-1573", "type_of_assistance": "The American Samoa Child Care Program (AS CCP) provides for the following assistance for families: offers subsidies to help with child care expenses; guidance in selecting a child care provider; information about quality child care programs; and referrals to community resources for help with other needs or concerns." }, { "category": "Financial Assistance", "entity": "American Samoa Financial Assistance for Families", "entity_url": "https://childcare.gov/state-resources?state=115&type=202", "phones": [], "telephone": "Online search", "type_of_assistance": "Provide resources at the state and local level,likeChild Care Financial Assistance, Children's Health Insurance Program (CHIP), WIC, Supplemental Nutritional Assistance Program." }, { "category": "Financial Assistance", "entity": "U.S. Small Business Administration Disaster Customer Service Center (SBA)", "entity_url": "https://www.sba.gov/funding-programs/disaster-assistance", "phones": [ "800-659-2955", "800-877-8339" ], "telephone": "800-659-2955 TTY: 800-877-8339", "type_of_assistance": "Low interest mortgages, personal property, and economic injury loans are available to homeowners, renters, and business owners affected by the disaster." }, { "category": "Health Care Services", "entity": "American Samoa Government Department of Health", "entity_url": null, "phones": [ "684-633-5871" ], "telephone": "684-633-5871", "type_of_assistance": "Public Health information, communicable disease control, and local health dispensaries." }, { "category": "Housing", "entity": "American Samoa Department of Housing and Urban Development", "entity_url": "https://www.hud.gov/states/hawaii/working/cpd/contactsas", "phones": [ "684-633-5155" ], "telephone": "684-633-5155", "type_of_assistance": "Territory development, consumer loans, and federal programs." }, { "category": "Insurance", "entity": "American Samoa | Medicaid", "entity_url": "https://www.medicaid.gov%2Fstate-overviews%2Famerican-samoa.html&usg=AOvVaw0t_Vrwi22DlqofGsfTaOSl", "phones": [ "684-699-4777" ], "telephone": "684-699-4777", "type_of_assistance": "Medicaid information" }, { "category": "Insurance", "entity": "American Samoa Consumer Assistance: Department of Insurance", "entity_url": "https://www.cms.gov/CCIIO/Resources/Consumer-Assistance-Grants/AS", "phones": [ "684-633-4116" ], "telephone": "684-633-4116", "type_of_assistance": "Consumer Information & Insurance Oversight." }, { "category": "Legal Services", "entity": "American Samoa Legal Aid", "entity_url": "https://www.aslegalaid.org/", "phones": [ "684-633-3300", "684-633-3301" ], "telephone": "684-633-3300 or 684-633-3301", "type_of_assistance": "Legal resources" }, { "category": "Legal Services", "entity": "American Samoa Bar Association", "entity_url": "http://www.asbar.org/", "phones": [], "telephone": "Online lawyer directory", "type_of_assistance": "Public resources, lawyer directory, legal information." }, { "category": "Tax Preparation", "entity": "American Samoa Tax Office - Department of the Treasury", "entity_url": "https://www.americansamoa.gov/tax-office", "phones": [ "684-633-4155" ], "telephone": "684-633-4155", "type_of_assistance": "American Samoa tax information for individuals and businesses." }, { "category": "Veterans Services", "entity": "American Samoa Veterans Affairs", "entity_url": "https://www.va.gov/directory/guide/facility.asp?ID=5982&dnum=All", "phones": [ "800-273-8255", "800-698-2411", "684-699-3760" ], "telephone": "Crisis Line: 800-273-8255 // 800-698-2411; 684-699-3760", "type_of_assistance": "Veterans benefits, and resources" }, { "category": "Vital Statistics", "entity": "National Center for Health Statistics", "entity_url": "https://www.cdc.gov/nchs/w2w/american_samoa.htm", "phones": [ "684-633-4606", "686-633-2262" ], "telephone": "684-633-4606 or 686-633-2262", "type_of_assistance": "Replacement Birth or Death records." }, { "category": "Volunteer", "entity": "VOLUNTEERS SHOULD NOT SELF-DEPLOY", "entity_url": null, "phones": [], "telephone": null, "type_of_assistance": null } ], "entry_count": 24, "last_updated": "2026-03-19T14:49:18+00:00", "node_id": 622122, "observed_at_ms": 1790463886752, "referrals_last_updated": "March 2026", "slug": "american-samoa", "title": "American Samoa Local-Level Referrals", "total_entries": 24, "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/american-samoa" } ``` ### Get national referrals - Capability: `us-disaster-assistance/get_national_referrals` - Description: The National Referral List (/assistance/individual/disaster-survivors/national-referral-list): the service categories the list covers and every row of the national-level referral table (category, entity, link, type of assistance, telephone text and parsed phone numbers), with the page's last-updated timestamp. - Instructions: Find national-level disaster recovery resources (FEMA helpline, Red Cross, SBA, IRS, VA, HUD, ...) that apply in every state and territory. - Cost: 5 credits per call - Capability file: [Get national referrals](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/get_national_referrals) Accepted options: - `category_contains` (string): Optional case-insensitive substring filter on the Category cell, e.g. `Housing`, `Crisis`, `Legal`. Without it every row is returned. Example: `` Response schema example: ```json { "categories": [ "Access & Disability", "Environment", "Missing Persons", "Aging Services", "Essential Needs", "Roadside Assistance", "Agricultural Aid", "Family & Protective Services", "Social Security", "American Red Cross", "Financial Assistance", "Students", "Animals/Pets", "Fraud", "Tax Preparation", "Citizenship", "Health Care Services", "Treasury Services", "Consumer Services", "Housing", "United States Postal Service", "Contractors", "Identity Theft", "Veterans Services", "Crisis Counseling", "Insurance", "Vital Statistics", "Disaster Unemployment Assistance", "Legal Services", "Volunteer" ], "category_filter": "Housing", "entries": [ { "category": "Housing", "entity": "HUD - Public & Indian Housing Customer Service Center", "entity_url": "https://www.hud.gov/program_offices/public_indian_housing", "phones": [ "800-955-2232" ], "telephone": "Benefit Finder: 800-955-2232", "type_of_assistance": "Individuals searching for affordable housing. Overview of information for Public and Indian Housing (PIH). Applicants will be given the telephone number of their local HUD Public and Indian Housing Office where they can apply for public housing assistance." }, { "category": "Housing", "entity": "HUD Portal - Local Offices", "entity_url": "https://portal.hud.gov/hudportal/HUD?src=/program_offices/field_policy_mgt/localoffices", "phones": [], "telephone": "Refer to website", "type_of_assistance": "Website provides a HUD Regional Office Directory" }, { "category": "Housing", "entity": "HUD - Housing Counseling Referral Line", "entity_url": "https://portal.hud.gov/hudportal/HUD?src=/i_want_to/talk_to_a_housing_counselor", "phones": [ "800-569-4287" ], "telephone": "800-569-4287", "type_of_assistance": "Individuals will be given the telephone number of their local HUD Counseling Office for assistance with rentals and mortgage services." }, { "category": "Housing", "entity": "HUD Disaster Resources", "entity_url": "https://www.hud.gov/info/disasterresources", "phones": [ "800-304-9320" ], "telephone": "800-304-9320", "type_of_assistance": "HUD FHA Resource Center." }, { "category": "Housing", "entity": "Operation Hope National Call Center - Mortgage Crisis Hotline", "entity_url": "http://www.operationhope.org/", "phones": [ "888-388-4673" ], "telephone": "888-388-4673", "type_of_assistance": "Assistance in disaster counseling, in deferring mortgage payments, replacing important documents, filing insurance claims, emergency credit counseling, assistance in working with creditors, and disaster preparedness guides." } ], "entry_count": 5, "last_updated": "2026-06-26T19:06:20+00:00", "node_id": 618735, "observed_at_ms": 1790463909455, "title": "National Referral List", "total_entries": 107, "url": "https://www.fema.gov/assistance/individual/disaster-survivors/national-referral-list" } ``` ### List datasets - Capability: `us-disaster-assistance/list_datasets` - Description: The OpenFEMA dataset catalog (/api/open/v1/DataSets): every published dataset with its entity name, API version, title, record count, last refresh, data dictionary and landing page URLs and any deprecation notice, sorted by name; optionally narrowed to names containing a substring. `name` + `version` feed `get_dataset_fields` and `query_dataset`; each row also carries lastDataSetRefresh (reload time), accrualPeriodicity (refresh cadence), depNewURL (successor), webService, the catalogue hash and the bulk-file distribution (collection contract datasets/list). - Instructions: Discover which OpenFEMA datasets exist (NFIP claims, Hazard Mitigation, Public Assistance, IPAWS alerts, ...) and which version to query. - Cost: 5 credits per call - Capability file: [List datasets](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/list_datasets) Accepted options: - `name_contains` (string): Case-insensitive substring of the dataset entity name, e.g. `Disaster`, `Nfip`, `Hazard`. Pattern: ^[A-Za-z0-9 ]+$. Example: `` Response schema example: ```json { "count": 7, "datasets": [ { "accrualPeriodicity": "R/PT20M", "api_url": "https://www.fema.gov/api/open/v2/DisasterDeclarationsSummaries", "dataDictionary": "https://www.fema.gov/openfema-data-page/Disaster-Declarations-Summaries-v2", "depApiMessage": null, "depDate": null, "depNewURL": null, "distribution": [ { "format": "csv", "size_class": "small (10MB - 50MB)", "url": "https://www.fema.gov/api/open/v2/DisasterDeclarationsSummaries.csv" }, { "format": "json", "size_class": "small (10MB - 50MB)", "url": "https://www.fema.gov/api/open/v2/DisasterDeclarationsSummaries.json" }, { "format": "jsona", "size_class": "small (10MB - 50MB)", "url": "https://www.fema.gov/api/open/v2/DisasterDeclarationsSummaries.jsona" }, { "format": "jsonl", "size_class": "small (10MB - 50MB)", "url": "https://www.fema.gov/api/open/v2/DisasterDeclarationsSummaries.jsonl" }, { "format": "parquet", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v2/DisasterDeclarationsSummaries.parquet" } ], "hash": "9f788147783014a1d4f6c8f826dbc5db2612472a", "identifier": "openfema-47", "landingPage": "https://www.fema.gov/disasters/how-declared", "lastDataSetRefresh": "2026-10-25T02:26:17.750Z", "lastRefresh": "2025-09-25T13:40:12.615Z", "name": "DisasterDeclarationsSummaries", "recordCount": 70572, "title": "Disaster Declarations Summaries", "version": 2, "webService": "https://www.fema.gov/api/open/v2/DisasterDeclarationsSummaries" }, { "accrualPeriodicity": "R/PT20M", "api_url": "https://www.fema.gov/api/open/v1/FemaWebDisasterDeclarations", "dataDictionary": "https://www.fema.gov/openfema-data-page/fema-web-disaster-declarations-v1", "depApiMessage": null, "depDate": null, "depNewURL": null, "distribution": [ { "format": "csv", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterDeclarations.csv" }, { "format": "json", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterDeclarations.json" }, { "format": "jsona", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterDeclarations.jsona" }, { "format": "jsonl", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterDeclarations.jsonl" }, { "format": "parquet", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterDeclarations.parquet" } ], "hash": "667937283a433f2209aa59464417643618bb327f", "identifier": "openfema-25", "landingPage": "https://www.fema.gov/disasters", "lastDataSetRefresh": "2026-10-25T02:29:26.085Z", "lastRefresh": "2025-09-25T13:40:12.615Z", "name": "FemaWebDisasterDeclarations", "recordCount": 5289, "title": "FEMA Web Disaster Declarations", "version": 1, "webService": "https://www.fema.gov/api/open/v1/FemaWebDisasterDeclarations" }, { "accrualPeriodicity": "R/PT20M", "api_url": "https://www.fema.gov/api/open/v1/FemaWebDisasterSummaries", "dataDictionary": "https://www.fema.gov/openfema-data-page/fema-web-disaster-summaries-v1", "depApiMessage": null, "depDate": null, "depNewURL": null, "distribution": [ { "format": "csv", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterSummaries.csv" }, { "format": "json", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterSummaries.json" }, { "format": "jsona", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterSummaries.jsona" }, { "format": "jsonl", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterSummaries.jsonl" }, { "format": "parquet", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/FemaWebDisasterSummaries.parquet" } ], "hash": "8463ccd1fe8742c8dd479d5533d9248fd47c0517", "identifier": "openfema-24", "landingPage": "https://www.fema.gov/disasters", "lastDataSetRefresh": "2026-10-25T02:29:25.734Z", "lastRefresh": "2025-09-25T13:40:12.615Z", "name": "FemaWebDisasterSummaries", "recordCount": 4052, "title": "FEMA Web Disaster Summaries", "version": 1, "webService": "https://www.fema.gov/api/open/v1/FemaWebDisasterSummaries" }, { "accrualPeriodicity": "R/P1D", "api_url": "https://www.fema.gov/api/open/v2/HazardMitigationGrantProgramDisasterSummaries", "dataDictionary": "https://www.fema.gov/openfema-data-page/hazard-mitigation-grant-program-disaster-summaries-v2", "depApiMessage": "The Hazard Mitigation Grant Program Disaster Summaries V3 has replaced this dataset. As such, V2 has been deprecated. The data is frozen as of August 31, 2026. It will remain until October 15, 2026, at which time it will no longer be available. ", "depDate": "2026-10-15T00:00:00.000Z", "depNewURL": "https://www.fema.gov/openfema-data-page/hazard-mitigation-grant-program-disaster-summaries-v3", "distribution": [ { "format": "csv", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v2/HazardMitigationGrantProgramDisasterSummaries.csv" }, { "format": "json", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v2/HazardMitigationGrantProgramDisasterSummaries.json" }, { "format": "jsona", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v2/HazardMitigationGrantProgramDisasterSummaries.jsona" }, { "format": "jsonl", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v2/HazardMitigationGrantProgramDisasterSummaries.jsonl" }, { "format": "parquet", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v2/HazardMitigationGrantProgramDisasterSummaries.parquet" } ], "hash": "c371c349943419eff7d7552d4c6dc20f340abf6e", "identifier": "openfema-46", "landingPage": "https://www.fema.gov/grants/mitigation", "lastDataSetRefresh": "2026-08-31T18:56:56.203Z", "lastRefresh": "2026-09-16T20:25:32.062Z", "name": "HazardMitigationGrantProgramDisasterSummaries", "recordCount": 2597, "title": "Hazard Mitigation Grant Program - Disaster Summaries", "version": 2, "webService": "https://www.fema.gov/api/open/v2/HazardMitigationGrantProgramDisasterSummaries" }, { "accrualPeriodicity": "R/P1D", "api_url": "https://www.fema.gov/api/open/v3/HazardMitigationGrantProgramDisasterSummaries", "dataDictionary": "https://www.fema.gov/openfema-data-page/hazard-mitigation-grant-program-disaster-summaries-v3", "depApiMessage": null, "depDate": null, "depNewURL": null, "distribution": [ { "format": "csv", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v3/HazardMitigationGrantProgramDisasterSummaries.csv" }, { "format": "json", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v3/HazardMitigationGrantProgramDisasterSummaries.json" }, { "format": "jsona", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v3/HazardMitigationGrantProgramDisasterSummaries.jsona" }, { "format": "jsonl", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v3/HazardMitigationGrantProgramDisasterSummaries.jsonl" }, { "format": "parquet", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v3/HazardMitigationGrantProgramDisasterSummaries.parquet" } ], "hash": "999a5f81a816c995927888c3f8b1c4ddb1ebd4d3", "identifier": "openfema-106", "landingPage": "https://www.fema.gov/grants/mitigation", "lastDataSetRefresh": "2026-10-24T12:06:16.219Z", "lastRefresh": "2026-08-20T21:00:15.408Z", "name": "HazardMitigationGrantProgramDisasterSummaries", "recordCount": 2173, "title": "Hazard Mitigation Grant Program - Disaster Summaries", "version": 3, "webService": "https://www.fema.gov/api/open/v3/HazardMitigationGrantProgramDisasterSummaries" }, { "accrualPeriodicity": "irregular", "api_url": "https://www.fema.gov/api/open/v1/IndividualAssistanceHousingRegistrantsLargeDisasters", "dataDictionary": "https://www.fema.gov/openfema-data-page/individual-assistance-housing-registrants-large-disasters-v1", "depApiMessage": null, "depDate": null, "depNewURL": null, "distribution": [ { "format": "csv", "size_class": "large (500MB - 10GB)", "url": "https://www.fema.gov/about/reports-and-data/openfema/IndividualAssistanceHousingRegistrantsLargeDisasters.csv" }, { "format": "parquet", "size_class": "large (500MB - 10GB)", "url": "https://www.fema.gov/about/reports-and-data/openfema/IndividualAssistanceHousingRegistrantsLargeDisasters.parquet" } ], "hash": "54729ea95f46670f88e15672c212900be0cc5e18", "identifier": "openfema-23", "landingPage": "https://www.fema.gov/individual-disaster-assistance", "lastDataSetRefresh": "2022-11-21T17:31:06.654Z", "lastRefresh": "2026-07-27T22:39:30.327Z", "name": "IndividualAssistanceHousingRegistrantsLargeDisasters", "recordCount": 6367334, "title": "Individual Assistance Housing Registrants - Large Disasters", "version": 1, "webService": "https://www.fema.gov/api/open/v1/IndividualAssistanceHousingRegistrantsLargeDisasters" }, { "accrualPeriodicity": "R/P1Y", "api_url": "https://www.fema.gov/api/open/v1/NonDisasterAssistanceFirefighterGrants", "dataDictionary": "https://www.fema.gov/openfema-data-page/non-disaster-and-assistance-firefighter-grants-v1", "depApiMessage": null, "depDate": null, "depNewURL": null, "distribution": [ { "format": "csv", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/NonDisasterAssistanceFirefighterGrants.csv" }, { "format": "json", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/NonDisasterAssistanceFirefighterGrants.json" }, { "format": "jsona", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/NonDisasterAssistanceFirefighterGrants.jsona" }, { "format": "jsonl", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/NonDisasterAssistanceFirefighterGrants.jsonl" }, { "format": "parquet", "size_class": "tiny (< 10MB)", "url": "https://www.fema.gov/api/open/v1/NonDisasterAssistanceFirefighterGrants.parquet" } ], "hash": "a92c07764563344d26271dd41d0c09908cba69be", "identifier": "openfema-15", "landingPage": "https://www.fema.gov/grants", "lastDataSetRefresh": "2026-06-04T18:40:21.789Z", "lastRefresh": "2025-09-25T13:40:12.615Z", "name": "NonDisasterAssistanceFirefighterGrants", "recordCount": 77925, "title": "Non-Disaster and Assistance to Firefighter Grants", "version": 1, "webService": "https://www.fema.gov/api/open/v1/NonDisasterAssistanceFirefighterGrants" } ], "observed_at_ms": 1792895806678, "source_url": "https://www.fema.gov/api/open/v1/DataSets?$orderby=name%20asc%2Cversion%20asc&$top=1000&$count=true", "total": 58 } ``` ### List referral directories - Capability: `us-disaster-assistance/list_referral_directories` - Description: The State and Local Level Referral Lists index (/assistance/individual/disaster-survivors/state-local-referral-lists): the 24 disaster recovery service categories FEMA lists and every state or territory referral directory with its name, page slug and URL (56 entries, territories included). Slugs feed `get_local_referrals`. - Instructions: Discover which state or territory referral directories exist and their slugs before reading one. - Cost: 5 credits per call - Capability file: [List referral directories](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/list_referral_directories) Accepted options: Response schema example: ```json { "directories": [ { "name": "Alabama", "slug": "alabama", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/alabama" }, { "name": "Alaska", "slug": "alaska", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/alaska" }, { "name": "American Samoa", "slug": "american-samoa", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/american-samoa" }, { "name": "Arizona", "slug": "arizona", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/arizona" }, { "name": "Arkansas", "slug": "arkansas", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/arkansas" }, { "name": "California", "slug": "california", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/california" }, { "name": "Colorado", "slug": "colorado", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/colorado" }, { "name": "Commonwealth of the Northern Mariana Islands", "slug": "commonwealth-northern-mariana-islands", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/commonwealth-northern-mariana-islands" }, { "name": "Connecticut", "slug": "connecticut", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/connecticut" }, { "name": "Delaware", "slug": "delaware", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/delaware" }, { "name": "District of Columbia", "slug": "district-columbia", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/district-columbia" }, { "name": "Florida", "slug": "florida", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/florida" }, { "name": "Georgia", "slug": "georgia", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/georgia" }, { "name": "Guam", "slug": "guam", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/guam" }, { "name": "Hawaii", "slug": "hawaii", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/hawaii" }, { "name": "Idaho", "slug": "idaho", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/idaho" }, { "name": "Illinois", "slug": "illinois", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/illinois" }, { "name": "Indiana", "slug": "indiana", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/indiana" }, { "name": "Iowa", "slug": "iowa", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/iowa" }, { "name": "Kansas", "slug": "kansas", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/kansas" }, { "name": "Kentucky", "slug": "kentucky", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/kentucky" }, { "name": "Louisiana", "slug": "louisiana", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/louisiana" }, { "name": "Maine", "slug": "maine", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/maine" }, { "name": "Maryland", "slug": "maryland", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/maryland" }, { "name": "Massachusetts", "slug": "massachusetts", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/massachusetts" }, { "name": "Michigan", "slug": "michigan", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/michigan" }, { "name": "Minnesota", "slug": "minnesota", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/minnesota" }, { "name": "Mississippi", "slug": "mississippi", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/mississippi" }, { "name": "Missouri", "slug": "missouri", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/missouri" }, { "name": "Montana", "slug": "montana", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/montana" }, { "name": "Nebraska", "slug": "nebraska", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/nebraska" }, { "name": "Nevada", "slug": "nevada", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/nevada" }, { "name": "New Hampshire", "slug": "new-hampshire", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/new-hampshire" }, { "name": "New Jersey", "slug": "new-jersey", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/new-jersey" }, { "name": "New Mexico", "slug": "new-mexico", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/new-mexico" }, { "name": "New York", "slug": "new-york", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/new-york" }, { "name": "North Carolina", "slug": "north-carolina", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/north-carolina" }, { "name": "North Dakota", "slug": "north-dakota", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/north-dakota" }, { "name": "Ohio", "slug": "ohio", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/ohio" }, { "name": "Oklahoma", "slug": "oklahoma", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/oklahoma" }, { "name": "Oregon", "slug": "oregon", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/oregon" }, { "name": "Pennsylvania", "slug": "pennsylvania", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/pennsylvania" }, { "name": "Puerto Rico", "slug": "puerto-rico", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/puerto-rico" }, { "name": "Rhode Island", "slug": "rhode-island", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/rhode-island" }, { "name": "South Carolina", "slug": "south-carolina", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/south-carolina" }, { "name": "South Dakota", "slug": "south-dakota", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/south-dakota" }, { "name": "Tennessee", "slug": "tennessee", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/tennessee" }, { "name": "Texas", "slug": "texas", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/texas" }, { "name": "Utah", "slug": "utah", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/utah" }, { "name": "Vermont", "slug": "vermont", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/vermont" }, { "name": "Virgin Islands", "slug": "virgin-islands", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/virgin-islands" }, { "name": "Virginia", "slug": "virginia", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/virginia" }, { "name": "Washington", "slug": "washington", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/washington" }, { "name": "West Virginia", "slug": "west-virginia", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/west-virginia" }, { "name": "Wisconsin", "slug": "wisconsin", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/wisconsin" }, { "name": "Wyoming", "slug": "wyoming", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists/wyoming" } ], "directory_count": 56, "node_id": 624745, "observed_at_ms": 1790463905361, "service_categories": [ "Access & Disabilities", "Aging Services", "Agricultural Aid", "Animals/Pets", "Citizenship", "Consumer Services", "Contractors", "Crisis Counseling", "Disaster Unemployment", "Environment", "Essential Needs", "Family & Protective Services", "Financial Assistance", "Health Care Services", "Housing", "Identity Theft", "Insurance", "Legal Services", "Roadside Assistance", "Students", "Tax Preparation", "Veterans Services", "Vital Statistics", "Volunteer" ], "title": "State and Local Level Referral Lists", "url": "https://www.fema.gov/assistance/individual/disaster-survivors/state-local-referral-lists" } ``` ### Nri dictionary - Capability: `us-disaster-assistance/nri_dictionary` - Description: The NRI data dictionary (NRIDataDictionary.csv, shipped inside every table zip and read from the 653 KB States zip): one row per field of the NRI layers with alias, type, length, relevant layer, metric type and version; optionally filtered by a substring of the field name. - Instructions: To pick `fields` for nri_list / nri_get or to label the columns in `record.fields`. - Cost: 5 credits per call - Capability file: [Nri dictionary](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_dictionary) Accepted options: - `name_contains` (string): Case-insensitive substring of the field name, e.g. `WFIR`, `RISK_`, `SOVI`. Without it all ~480 rows are returned. Example: `` - `release` (string): Release path segment under /about/reports-and-data/openfema/nri/. FEMA serves only the current release (v120 = NRI v1.20, December 2025; v119 is a 404), so leave the default unless a newer release is published. Pattern: ^v[0-9]{3}$. Example: `v120` Response schema example: ```json { "field_count": 26, "fields": [ { "alias": "Wildfire - Number of Events", "length": 8, "metric_type": "Number of Events", "name": "WFIR_EVNTS", "relevant_layer": "Wildfire", "sort": 418, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Annualized Frequency", "length": 8, "metric_type": "Annualized Frequency", "name": "WFIR_AFREQ", "relevant_layer": "Wildfire", "sort": 419, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Exposure - Building Value", "length": 8, "metric_type": "Exposure - Building Value", "name": "WFIR_EXPB", "relevant_layer": "Wildfire", "sort": 420, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Exposure - Population", "length": 8, "metric_type": "Exposure - Population", "name": "WFIR_EXPP", "relevant_layer": "Wildfire", "sort": 421, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Exposure - Population Equivalence", "length": 8, "metric_type": "Exposure - Population Equivalence", "name": "WFIR_EXPPE", "relevant_layer": "Wildfire", "sort": 422, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Exposure - Agriculture Value", "length": 8, "metric_type": "Exposure - Agriculture Value", "name": "WFIR_EXPA", "relevant_layer": "Wildfire", "sort": 423, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Exposure - Total", "length": 8, "metric_type": "Exposure - Total", "name": "WFIR_EXPT", "relevant_layer": "Wildfire", "sort": 424, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Exposure - Impacted Area (sq mi)", "length": 8, "metric_type": "Exposure - Area", "name": "WFIR_EXP_AREA", "relevant_layer": "Wildfire", "sort": 425, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Historic Loss Ratio - Buildings", "length": 8, "metric_type": "Historic Loss Ratio - Buildings", "name": "WFIR_HLRB", "relevant_layer": "Wildfire", "sort": 426, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Historic Loss Ratio - Population", "length": 8, "metric_type": "Historic Loss Ratio - Population", "name": "WFIR_HLRP", "relevant_layer": "Wildfire", "sort": 427, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Historic Loss Ratio - Agriculture", "length": 8, "metric_type": "Historic Loss Ratio - Agriculture", "name": "WFIR_HLRA", "relevant_layer": "Wildfire", "sort": 428, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Historic Loss Ratio - Total Rating", "length": 50, "metric_type": "Historic Loss Ratio - Total Rating", "name": "WFIR_HLRR", "relevant_layer": "Wildfire", "sort": 429, "type": "String", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss - Building Value", "length": 8, "metric_type": "Expected Annual Loss - Building Value", "name": "WFIR_EALB", "relevant_layer": "Wildfire", "sort": 430, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss - Population", "length": 8, "metric_type": "Expected Annual Loss - Population", "name": "WFIR_EALP", "relevant_layer": "Wildfire", "sort": 431, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss - Population Equivalence", "length": 8, "metric_type": "Expected Annual Loss - Population Equivalence", "name": "WFIR_EALPE", "relevant_layer": "Wildfire", "sort": 432, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss - Agriculture Value", "length": 8, "metric_type": "Expected Annual Loss - Agriculture Value", "name": "WFIR_EALA", "relevant_layer": "Wildfire", "sort": 433, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss - Total", "length": 8, "metric_type": "Expected Annual Loss - Total", "name": "WFIR_EALT", "relevant_layer": "Wildfire", "sort": 434, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss Score", "length": 8, "metric_type": "Expected Annual Loss Score", "name": "WFIR_EALS", "relevant_layer": "Wildfire", "sort": 435, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss Rating", "length": 50, "metric_type": "Expected Annual Loss Rating", "name": "WFIR_EALR", "relevant_layer": "Wildfire", "sort": 436, "type": "String", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss Rate - Building", "length": 8, "metric_type": "Expected Annual Loss Rate - Building", "name": "WFIR_ALRB", "relevant_layer": "Wildfire", "sort": 437, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss Rate - Population", "length": 8, "metric_type": "Expected Annual Loss Rate - Population", "name": "WFIR_ALRP", "relevant_layer": "Wildfire", "sort": 438, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss Rate - Agriculture", "length": 8, "metric_type": "Expected Annual Loss Rate - Agriculture", "name": "WFIR_ALRA", "relevant_layer": "Wildfire", "sort": 439, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Expected Annual Loss Rate - National Percentile", "length": 8, "metric_type": "National Percentile", "name": "WFIR_ALR_NPCTL", "relevant_layer": "Wildfire", "sort": 440, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Hazard Type Risk Index Value", "length": 8, "metric_type": "Hazard Type Risk Index Value", "name": "WFIR_RISKV", "relevant_layer": "Wildfire", "sort": 441, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Hazard Type Risk Index Score", "length": 8, "metric_type": "Hazard Type Risk Index Score", "name": "WFIR_RISKS", "relevant_layer": "Wildfire", "sort": 442, "type": "Double", "version": "1.20.0", "version_date": "December 2025" }, { "alias": "Wildfire - Hazard Type Risk Index Rating", "length": 50, "metric_type": "Hazard Type Risk Index Rating", "name": "WFIR_RISKR", "relevant_layer": "Wildfire", "sort": 443, "type": "String", "version": "1.20.0", "version_date": "December 2025" } ], "member": "NRIDataDictionary.csv", "name_filter": "WFIR", "observed_at_ms": 1792859676495, "publication_id": "v120:a84917a21833b8092f386ae3c2814b67", "release": "v120", "source_url": "https://www.fema.gov/about/reports-and-data/openfema/nri/v120/NRI_Table_States.zip", "total_fields": 479 } ``` ### Nri get - Capability: `us-disaster-assistance/nri_get` - Description: One NRI row by its own id: counties by STCOFIPS or NRI_ID (30031 / C30031), states by STATEFIPS, NRI_ID or USPS code (30 / S30 / MT), tribal tables by OID_ or NRI_ID (first match, with match_count), tracts by TRACTFIPS or NRI_ID (30031000100 / T30031000100). The one-fetch tables are scanned from one zip download; a tract is found by a binary search of 64 KiB Range reads over the 634 MB CSV (about 15 reads; Connecticut tracts from one tail read), all pinned to one file MD5. - Instructions: Look up one county, state, tract or tribal row when you already know its FIPS or NRI_ID. - Cost: 5 credits per call - Capability file: [Nri get](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_get) Accepted options: - `fields` (string[]): Optional column selection for `record.fields` (names as in NRIDataDictionary.csv, e.g. RISK_SCORE, WFIR_RISKR, IFLD_EALT); the identity columns are always present at the record's top level. Without it every column of the row is returned (465-476 per row). Example: `["record.fields"]` - `id` (string, required): NRI_ID (C30031, T30031000100, S30), the bare FIPS (30031, 30031000100, 30), a USPS state code (MT) for states, or the OID_ row number for tribal tables. Pattern: ^[A-Za-z0-9]+$. Example: `` - `release` (string): Release path segment under /about/reports-and-data/openfema/nri/. FEMA serves only the current release (v120 = NRI v1.20, December 2025; v119 is a 404), so leave the default unless a newer release is published. Pattern: ^v[0-9]{3}$. Example: `v120` - `table` (string, required): Which NRI table: `states` (56 rows), `counties` (3,232), `tribal_counties` (1,232 county x tribal-area rows), `tribal_tracts` (3,364 tract x tribal-area rows) or `tracts` (~85,155 census tracts, 634 MB, read by byte range). Example: `states` Response schema example: ```json { "id": "C30031", "match_count": 1, "observed_at_ms": 1792859740434, "publication_id": "v120:587c5774b50eb880ea93e13f60aec8e9", "record": { "county": "Gallatin", "county_type": "County", "fields": { "EAL_RATNG": "Relatively Moderate", "IFLD_RISKR": "Relatively Low", "POPULATION": "118825", "RESL_RATNG": "Relatively High", "RISK_RATNG": "Relatively Moderate", "RISK_SCORE": "80.979643765903305", "SOVI_RATNG": "Very Low", "WFIR_RISKR": "Relatively Moderate" }, "nri_id": "C30031", "nri_ver": "December 2025", "oid": 1615, "publication_id": "v120:587c5774b50eb880ea93e13f60aec8e9", "retrieved_at": "2026-10-24T16:35:38Z", "source_record_id": "C30031", "source_url": "https://www.fema.gov/about/reports-and-data/openfema/nri/v120/NRI_Table_Counties.zip", "state": "Montana", "state_abbrv": "MT", "state_fips": "30", "stcofips": "30031", "tract": null, "tractfips": null }, "release": "v120", "source_url": "https://www.fema.gov/about/reports-and-data/openfema/nri/v120/NRI_Table_Counties.zip", "table": "counties", "upstream_reads": 1 } ``` ### Nri hazards - Capability: `us-disaster-assistance/nri_hazards` - Description: The NRI hazard catalogue (NRI_HazardInfo.csv, shipped inside every table zip and read from the 653 KB States zip): the 18 hazards with their four-letter column prefixes (AVLN, CFLD, CWAV, DRGT, ERQK, HAIL, HWAV, HRCN, ISTM, IFLD, LNDS, LTNG, SWND, TRND, TSUN, VLCN, WFIR, WNTW), period of record, frequency model and which expected-annual-loss components apply. - Instructions: To expand `_EVNTS`, `_AFREQ`, `_EXPT`, `_HLRB`, `_EALT`, `_EALS`, `_EALR`, `_RISKV`, `_RISKS`, `_RISKR` column names into hazards. - Cost: 5 credits per call - Capability file: [Nri hazards](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_hazards) Accepted options: - `release` (string): Release path segment under /about/reports-and-data/openfema/nri/. FEMA serves only the current release (v120 = NRI v1.20, December 2025; v119 is a 404), so leave the default unless a newer release is published. Pattern: ^v[0-9]{3}$. Example: `v120` Response schema example: ```json { "hazard_count": 18, "hazards": [ { "eal_agriculture": false, "eal_building": true, "eal_population": true, "end": "2023", "frequency_model": "Annualized Frequency", "hazard": "Avalanche", "nri_ver": "December 2025", "oid": 1, "period_of_record": "1994-2023 (30 years)", "prefix": "AVLN", "service": "Avalanche", "start": "1994", "total_years": "30" }, { "eal_agriculture": false, "eal_building": true, "eal_population": true, "end": "2025", "frequency_model": "Probability", "hazard": "Coastal Flooding", "nri_ver": "December 2025", "oid": 2, "period_of_record": "Various (see documentation)", "prefix": "CFLD", "service": "CoastalFlooding", "start": "2025", "total_years": "1" }, { "eal_agriculture": true, "eal_building": true, "eal_population": true, "end": "2024", "frequency_model": "Annualized Frequency", "hazard": "Cold Wave", "nri_ver": "December 2025", "oid": 3, "period_of_record": "2005-2024 (19 years)", "prefix": "CWAV", "service": "ColdWave", "start": "2005", "total_years": "19" }, { "eal_agriculture": true, "eal_building": false, "eal_population": false, "end": "2025", "frequency_model": "Annualized Frequency", "hazard": "Drought", "nri_ver": "December 2025", "oid": 4, "period_of_record": "2000-2025 (25 years)", "prefix": "DRGT", "service": "Drought", "start": "2000", "total_years": "25" }, { "eal_agriculture": false, "eal_building": true, "eal_population": true, "end": "2024", "frequency_model": "Probability", "hazard": "Earthquake", "nri_ver": "December 2025", "oid": 5, "period_of_record": "2024 dataset", "prefix": "ERQK", "service": "Earthquake", "start": "2024", "total_years": "1" }, { "eal_agriculture": true, "eal_building": true, "eal_population": true, "end": "2023", "frequency_model": "Annualized Frequency", "hazard": "Hail", "nri_ver": "December 2025", "oid": 6, "period_of_record": "1986-2023 (38 years)", "prefix": "HAIL", "service": "Hail", "start": "1986", "total_years": "38" }, { "eal_agriculture": true, "eal_building": true, "eal_population": true, "end": "2024", "frequency_model": "Annualized Frequency", "hazard": "Heat Wave", "nri_ver": "December 2025", "oid": 7, "period_of_record": "2005-2024 (19 years)", "prefix": "HWAV", "service": "HeatWave", "start": "2005", "total_years": "19" }, { "eal_agriculture": true, "eal_building": true, "eal_population": true, "end": "2024", "frequency_model": "Annualized Frequency", "hazard": "Hurricane", "nri_ver": "December 2025", "oid": 8, "period_of_record": "East 1851-2024 (173 years) / West 1949-2024 (76 years)", "prefix": "HRCN", "service": "Hurricane", "start": "1851/1949", "total_years": "173/76" }, { "eal_agriculture": false, "eal_building": true, "eal_population": true, "end": "2014", "frequency_model": "Annualized Frequency", "hazard": "Ice Storm", "nri_ver": "December 2025", "oid": 9, "period_of_record": "1946-2014 (67 years)", "prefix": "ISTM", "service": "IceStorm", "start": "1946", "total_years": "67" }, { "eal_agriculture": true, "eal_building": true, "eal_population": true, "end": "2023", "frequency_model": "Annualized Frequency", "hazard": "Inland Flooding", "nri_ver": "December 2025", "oid": 10, "period_of_record": "1996-2023 (28 years)", "prefix": "IFLD", "service": "InlandFlooding", "start": "1996", "total_years": "28" }, { "eal_agriculture": false, "eal_building": true, "eal_population": true, "end": "2023", "frequency_model": "Probability", "hazard": "Landslide", "nri_ver": "December 2025", "oid": 11, "period_of_record": "2023 dataset", "prefix": "LNDS", "service": "Landslide", "start": "2023", "total_years": "1" }, { "eal_agriculture": false, "eal_building": true, "eal_population": true, "end": "2023", "frequency_model": "Probability", "hazard": "Lightning", "nri_ver": "December 2025", "oid": 12, "period_of_record": "2023 dataset", "prefix": "LTNG", "service": "Lightning", "start": "2023", "total_years": "1" }, { "eal_agriculture": true, "eal_building": true, "eal_population": true, "end": "2023", "frequency_model": "Annualized Frequency", "hazard": "Strong Wind", "nri_ver": "December 2025", "oid": 13, "period_of_record": "1986-2023 (38 years)", "prefix": "SWND", "service": "StrongWind", "start": "1986", "total_years": "38" }, { "eal_agriculture": true, "eal_building": true, "eal_population": true, "end": "2023", "frequency_model": "Annualized Frequency", "hazard": "Tornado", "nri_ver": "December 2025", "oid": 14, "period_of_record": "1986-2023 (38 years)", "prefix": "TRND", "service": "Tornado", "start": "1986", "total_years": "38" }, { "eal_agriculture": false, "eal_building": true, "eal_population": true, "end": "2021", "frequency_model": "Probability", "hazard": "Tsunami", "nri_ver": "December 2025", "oid": 15, "period_of_record": "Various (see documentation)", "prefix": "TSUN", "service": "Tsunami", "start": "2021", "total_years": "1" }, { "eal_agriculture": false, "eal_building": true, "eal_population": true, "end": "2023", "frequency_model": "Probability", "hazard": "Volcanic Activity", "nri_ver": "December 2025", "oid": 16, "period_of_record": "2023 dataset", "prefix": "VLCN", "service": "VolcanicActivity", "start": "2023", "total_years": "1" }, { "eal_agriculture": true, "eal_building": true, "eal_population": true, "end": "2024", "frequency_model": "Probability", "hazard": "Wildfire", "nri_ver": "December 2025", "oid": 17, "period_of_record": "2024 dataset", "prefix": "WFIR", "service": "Wildfire", "start": "2024", "total_years": "1" }, { "eal_agriculture": true, "eal_building": true, "eal_population": true, "end": "2024", "frequency_model": "Annualized Frequency", "hazard": "Winter Weather", "nri_ver": "December 2025", "oid": 18, "period_of_record": "2005-2024 (19 years)", "prefix": "WNTW", "service": "WinterWeather", "start": "2005", "total_years": "19" } ], "member": "NRI_HazardInfo.csv", "observed_at_ms": 1792859635593, "publication_id": "v120:a84917a21833b8092f386ae3c2814b67", "release": "v120", "source_url": "https://www.fema.gov/about/reports-and-data/openfema/nri/v120/NRI_Table_States.zip" } ``` ### Nri list - Capability: `us-disaster-assistance/nri_list` - Description: Rows of one NRI table as records pinned to a publication. states, counties, tribal_counties and tribal_tracts are one zip fetch per page (653 KB to 26.6 MB) with an optional state filter and `limit`/`cursor` row paging; tracts (634 MB) are read by byte range, one Range request of `page_bytes` per page cut at the last row boundary, cursor = publication MD5 + next byte offset. Any page whose file MD5 differs from the cursor's fails with invalid_input `publication_changed`. - Instructions: Bulk collection of county, tract, state or tribal risk rows (RISK_*, EAL_*, SOVI_*, RESL_* and the 18 hazard blocks). Use `fields` to keep pages small; use nri_get for one row. - Cost: 5 credits per call - Capability file: [Nri list](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_list) Accepted options: - `cursor` (string): `next_cursor` of the previous page (opaque, pinned to the file MD5). Example: `next_cursor` - `fields` (string[]): Optional column selection for `record.fields` (names as in NRIDataDictionary.csv, e.g. RISK_SCORE, WFIR_RISKR, IFLD_EALT); the identity columns are always present at the record's top level. Without it every column of the row is returned (465-476 per row). Example: `["record.fields"]` - `limit` (number): Rows per page for the four one-fetch tables. Example: `100` - `page_bytes` (number): Tracts only: bytes per Range request (256 KiB to 24 MiB; about 130 rows per MiB). Example: `8388608` - `release` (string): Release path segment under /about/reports-and-data/openfema/nri/. FEMA serves only the current release (v120 = NRI v1.20, December 2025; v119 is a 404), so leave the default unless a newer release is published. Pattern: ^v[0-9]{3}$. Example: `v120` - `state` (string): Keep only one state or territory: USPS code (`MT`) or STATEFIPS (`30`). Not available on `tracts` (no state index in a byte-range read). Example: `` - `table` (string, required): Which NRI table: `states` (56 rows), `counties` (3,232), `tribal_counties` (1,232 county x tribal-area rows), `tribal_tracts` (3,364 tract x tribal-area rows) or `tracts` (~85,155 census tracts, 634 MB, read by byte range). Example: `states` Response schema example: ```json { "byte_range": null, "csv_bytes": 325704, "etag_md5": "a84917a21833b8092f386ae3c2814b67", "file_bytes": 653019, "last_modified": "Thu, 18 Dec 2025 22:01:58 GMT", "matched_rows": 1, "next_cursor": null, "observed_at_ms": 1792859723826, "offset": 0, "publication_id": "v120:a84917a21833b8092f386ae3c2814b67", "record_count": 1, "records": [ { "county": null, "county_type": null, "fields": { "BUILDVALUE": "302422270621.000000000000000", "EAL_RATNG": "Relatively Low", "EAL_SCORE": "25.000000000000000", "EAL_VALT": "753801508.146182537078857", "IFLD_EALT": "277485767.627954483032227", "POPULATION": "1082451", "WFIR_EALT": "72702274.413601875305176", "WFIR_EVNTS": null }, "nri_id": "S30", "nri_ver": "December 2025", "oid": 27, "publication_id": "v120:a84917a21833b8092f386ae3c2814b67", "retrieved_at": "2026-10-24T16:35:23Z", "source_record_id": "S30", "source_url": "https://www.fema.gov/about/reports-and-data/openfema/nri/v120/NRI_Table_States.zip", "state": "Montana", "state_abbrv": "MT", "state_fips": "30", "stcofips": null, "tract": null, "tractfips": null } ], "release": "v120", "source_url": "https://www.fema.gov/about/reports-and-data/openfema/nri/v120/NRI_Table_States.zip", "state_filter": "MT", "table": "states", "total_rows": 56 } ``` ### Nri status - Capability: `us-disaster-assistance/nri_status` - Description: National Risk Index (NRI) release check: for each table zip under /about/reports-and-data/openfema/nri// its URL, size, ETag (whose first segment is the file MD5), Last-Modified, CSV layout and the NRI_VER label, from a 24 KiB Range read per file. No record counts (they need a full read; nri_list reports total_rows). - Instructions: Start here to learn the current publication_id and file sizes before paging with nri_list, or to detect a new release. - Cost: 5 credits per call - Capability file: [Nri status](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/nri_status) Accepted options: - `release` (string): Release path segment under /about/reports-and-data/openfema/nri/. FEMA serves only the current release (v120 = NRI v1.20, December 2025; v119 is a 404), so leave the default unless a newer release is published. Pattern: ^v[0-9]{3}$. Example: `v120` - `table` (string): Check one table only (one upstream request instead of five). Example: `states` Response schema example: ```json { "base_url": "https://www.fema.gov/about/reports-and-data/openfema/nri/v120/", "file_count": 1, "files": [ { "bytes": 653019, "columns": 313, "content_hash": { "algorithm": "md5", "value": "a84917a21833b8092f386ae3c2814b67" }, "csv_bytes": 325704, "csv_member": "NRI_Table_States.csv", "csv_offset": 50, "etag": "\"a84917a21833b8092f386ae3c2814b67:1766095318.995623\"", "file": "NRI_Table_States.zip", "last_modified": "Thu, 18 Dec 2025 22:01:58 GMT", "nri_ver": "December 2025", "publication_id": "v120:a84917a21833b8092f386ae3c2814b67", "table": "states", "url": "https://www.fema.gov/about/reports-and-data/openfema/nri/v120/NRI_Table_States.zip" } ], "observed_at_ms": 1792859689046, "release": "v120", "total_bytes": 653019, "version": "December 2025" } ``` ### Query dataset - Capability: `us-disaster-assistance/query_dataset` - Description: Generic OData query over any OpenFEMA dataset (/api/open/v{version}/{entity}): raw `$filter`, `$select` and `$orderby` with `$top`/`$skip` paging and the server's total count. Records are returned as OpenFEMA sends them (open objects; see `get_dataset_fields` for the field list). An unknown entity or version is `not_found`; a filter the OData parser rejects (code OF_OQP_*) is `invalid_input` with the server's message; the large datasets (IHP registrations, PA funded projects) share a bucket of 2 requests per 60 seconds and answer `upstream_rate_limited` beyond it. - Instructions: Read any OpenFEMA dataset the dedicated functions do not cover: IPAWS alerts, NFIP claims and policies, Hazard Mitigation grants, Public Assistance projects, IHP registrations, declaration denials, FEMA regions, ... - Cost: 5 credits per call - Capability file: [Query dataset](https://firecrawl.dev/alexandria/agents/providers/fema-gov/us-disaster-assistance/query_dataset) Accepted options: - `entity` (string, required): Dataset entity name, e.g. `IpawsArchivedAlerts`, `DeclarationDenials`, `FemaRegions`. Pattern: ^[A-Za-z][A-Za-z0-9]*$. Example: `` - `filter` (string): Raw OData $filter, e.g. `disasterNumber eq 4931`, `state eq 'TX' and declarationDate ge '2025-01-01T00:00:00.000Z'`. Strings in single quotes; `and`/`or`/`eq`/`ne`/`gt`/`ge`/`lt`/`le`/`in`/`substringof`/`startswith`. Example: `disasterNumber eq 4931` - `orderby` (string): OData $orderby, e.g. `declarationDate desc`. Pattern: ^[A-Za-z0-9_]+( (asc|desc|ASC|DESC))?(,\s*[A-Za-z0-9_]+( (asc|desc|ASC|DESC))?)*$. Example: `declarationDate desc` - `select` (string): Comma-separated field names to return (OData $select). Pattern: ^[A-Za-z0-9_]+(,\s*[A-Za-z0-9_]+)*$. Example: `