{"contractVersion":"parcelops.connector.v1","name":"openfema","displayName":"OpenFEMA Property Risk","description":"FEMA disaster declarations, NFIP claims aggregates, public assistance, and hazard context for US market research.","tags":["property-risk","disasters","flood-claims","fema","united-states"],"authentication":{"type":"none","required":false},"provenance":{"sourceName":"FEMA OpenFEMA API","sourceUrl":"https://www.fema.gov/api/open","apiBaseUrl":"https://www.fema.gov/api/open","documentationUrl":"https://www.fema.gov/about/openfema"},"freshness":{"status":"not_declared"},"coverage":{"geographic":{"status":"declared","value":["United States"]},"temporal":{"status":"not_declared"}},"methods":{"total":3,"items":[{"name":"searchDisasterDeclarations","description":"Search federal disaster declarations by place, incident, year, date, or declaration type.","notes":"Use distinctBy=disasterNumber for unique disasters instead of designated areas.","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$"},"county":{"type":"string","maxLength":160},"incidentType":{"type":"string","maxLength":80},"declarationType":{"type":"string","enum":["DR","EM","FM"]},"year":{"type":"integer","minimum":1953,"maximum":2200},"beginDate":{"type":"string","description":"ISO date YYYY-MM-DD."},"endDate":{"type":"string","description":"ISO date YYYY-MM-DD."},"distinctBy":{"type":"string","enum":["disasterNumber"]},"limit":{"type":"integer","minimum":1,"maximum":1000},"offset":{"type":"integer","minimum":0}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"declared","value":{"mode":"near_real_time","cadence":"PT20M"},"scope":"method"},"entities":{"status":"declared","value":["disaster-declaration"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"declared","value":{"type":"object","properties":{"count":{"type":"integer","minimum":0},"total":{"type":["integer","null"],"minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1},"declarations":{"type":"array","items":{"type":"object","additionalProperties":true}},"note":{"type":"string"}},"required":["count","total","offset","limit","declarations","note"],"additionalProperties":true}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":["Disaster Declarations Summaries county-level data are incomplete before 1964.","Historic Fire Management Assistance data are partial."]},{"name":"searchNfipClaims","description":"Search public NFIP flood claims by state, county, year, date of loss, zone, or occupancy.","notes":"County name resolves to a 5-digit FIPS; an unmatched name errors, never widens.","inputSchema":{"type":"object","properties":{"state":{"type":"string","pattern":"^[A-Za-z]{2}$","description":"2-letter state or territory postal code."},"county":{"type":"string","maxLength":120,"description":"County, parish, or borough name (\"Orleans\" or \"Orleans Parish\"). The dataset stores no county name, so this is resolved against the Census county-equivalent catalog and the query filters on the resulting 5-digit FIPS. Pass state too unless the name is nationally unique. A name that matches nothing, or matches more than one county, is an error — it never widens to the whole state."},"countyCode":{"type":"string","pattern":"^\\d{5}$","description":"5-digit county FIPS (state + county), e.g. \"22071\" for Orleans Parish, LA. Use instead of county when the code is already known."},"year":{"type":"integer","minimum":1973,"maximum":2200,"description":"Year of loss, e.g. 2017 for Hurricane Harvey."},"dateOfLossBegin":{"type":"string","description":"ISO date YYYY-MM-DD, inclusive lower bound on date of loss."},"dateOfLossEnd":{"type":"string","description":"ISO date YYYY-MM-DD, inclusive upper bound on date of loss."},"ratedFloodZone":{"type":"string","maxLength":4,"description":"NFIP rated flood zone: A, AE, AH, AO, B, C, D, V, VE, X, plus numbered A01-A30 and V01-V15. The literal \"null\" is a real upstream value for pre-FIRM properties with no recorded zone. Full list: getServiceInfo enumValues."},"occupancyType":{"type":"integer","enum":[1,2,3,4,6],"description":"1 single family, 2 two-to-four family, 3 other residential, 4 non-residential, 6 condominium."},"limit":{"type":"integer","minimum":1,"maximum":1000},"offset":{"type":"integer","minimum":0}},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"declared","value":["nfip-claim"]},"pagination":{"status":"declared","value":{"style":"offset","offsetField":"offset","limitField":"limit"}},"output":{"schema":{"status":"declared","value":{"type":"object","properties":{"count":{"type":"integer","minimum":0},"total":{"type":["integer","null"],"minimum":0},"offset":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1},"claims":{"type":"array","items":{"type":"object","additionalProperties":true}},"note":{"type":"string"}},"required":["count","total","offset","limit","claims","note"],"additionalProperties":true}},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":[]},{"name":"getServiceInfo","description":"Return dataset versions, cadence, and caveats.","inputSchema":{"type":"object","properties":{},"required":[],"additionalProperties":false},"access":{"classification":"read"},"freshness":{"status":"not_declared"},"entities":{"status":"not_declared"},"pagination":{"status":"not_declared"},"output":{"schema":{"status":"not_declared"},"units":{"status":"not_declared"},"coordinateReferenceSystem":{"status":"not_declared"}},"caveats":[]}]},"caveats":[]}