U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.

Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.

Https

The site is secure.

The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.

Developer Resources

Welcome to the OpenFEMA Developer Resources page, devoted to providing additional development information regarding our Application Programming Interface (API) for use in your applications and mashups.  The API is free of charge and does not currently have user registration requirements.  Please contact the OpenFEMA Team at openfema@fema.dhs.gov  to suggest additional datasets and additional API features. We also welcome any code examples you would like to provide.

Please review the API Documentation for list of commands that can be used for each endpoint. As OpenFEMA’s main purpose is to act as a content delivery mechanism, each endpoint represents a dataset. Therefore, the documentation does not outline each one; they all operate in the same manner. Metadata for each dataset can be found on the individual dataset pages.

The Changelog identifies new, changing, and deprecated datasets, and describes new features to the API.

The  API Specifics/Technical portion of the FAQ may be of particular interest to developers.

Datasets Available via API 

Accessing data

There are many ways to access data from the OpenFEMA API. One way, of course, is to use a programming language. The Common Examples section below illustrates how to accomplish many different things using different languages. Some other, simple methods are outlined here. All of these examples will return disaster summaries for Hurricane Isabell (disaster number 1491).

HTTP/URL | cURL | Wget | PowerShell 3.0

# HTTP/URL – Paste in your browsers URL bar.

https://www.fema.gov/api/open/v1/DisasterDeclarationsSummaries?$filter=disasterNumber eq 1491

# cURL – Saving returned data to a file. Note URL %20 encoding used for spaces.

curl ‘https://www.fema.gov/api/open/v1/DisasterDeclarationsSummaries?$filter=disasterNumber%20eq%201491’ >> output.txt

# Wget – Saving returned data to a file.

wget –O output.txt ‘https://www.fema.gov/api/open/v1/DisasterDeclarationsSummaries?$filter=disasterNumber%20eq%201491’

# Windows PowerShell 3.0 – Note site security uses TLS 1.2, therefore the security protocol must be set first.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Invoke-WebRequest -Uri https://www.fema.gov/api/open/v1/DisasterDeclarationsSummaries?$filter=disasterNumber%20eq%201491 –OutFile c:\temp\output.txt

Common Examples

Retrieving data

PHP | Javascript | Python | .NET | Java

Periodic updates

Checking dataset data updates

Converting json to different format

Paging through data

Other

Time formats?

A note on metadata functions?

See Also

OData link

API documentation

Changelog

Last updated Jun 30, 2020

Would you like to take a brief survey regarding your experience with fema.gov?