---
title: "OpenFEMA Data Sets"
method: GET
path: "/v1/DataSets"
tags: ["Miscellaneous"]
---

# OpenFEMA Data Sets

`GET /v1/DataSets`

## Request

- Base URL: `https://www.fema.gov/api/open`
- URL: `https://www.fema.gov/api/open/v1/DataSets`
- Auth: none declared
- TypeScript: <https://skmtc.dev/fema/apis/openfema-api/docs/v1/DataSets/get.ts> (a function with typed inputs; its response is checked against the schema)

Metadata for the OpenFEMA API data sets. It contains attributes regarding the published datasets including but not limited to update frequency, description, version, and deprecation status.

Citation: FEMA's citation requirements for datasets (API usage or file downloads) can be found on the OpenFEMA Terms and Conditions page, Citing Data section: https://www.fema.gov/about/openfema/terms-conditions.

For answers to Frequently Asked Questions (FAQs) about the OpenFEMA program, API, and publicly available datasets, please visit: https://www.fema.gov/about/openfema/faq.
If you have media inquiries about this dataset, please email the FEMA Press Office at FEMA-Press-Office@fema.dhs.gov. For inquiries about FEMA's data and Open Government program, please email the OpenFEMA team at OpenFEMA@fema.dhs.gov.

## Query parameters

- `$filter` string
- `$top` integer
- `$skip` integer
- `$count` boolean
- `$filename` string
- `$metadata` boolean
- `$gzip` boolean
- `$orderby` string[]
- `$select` string[]
- `$format` 'json' | 'jsona' | 'csv' | 'jsonl' | 'parquet'

## Response `200`

OK

- object
  - `metadata` Metadata
    - `skip` number, nullable
    - `filter` string, nullable
    - `orderBy` string, nullable
    - `select` string, nullable
    - `rundate` string, nullable
    - `top` number, nullable
    - `format` string, nullable
    - `metadata` boolean, nullable
    - `entityname` string
    - `version` string
    - `url` string
    - `count` number, nullable
  - `DataSets` V1DataSets[]
    - `identifier` string, string: Unique, textual identifier for a dataset.
    - `name` string, string: Name of the dataset.
    - `title` string, string: Human-readable, verbose name of the dataset.
    - `description` string, string: Dataset description. Detailed enough to enable a user to quickly understand whether the asset is of interest.
    - `distribution` object[], nullable
    - `webService` string, string: Endpoint of web service to access dataset. The URL for an indirect means of accessing the dataset through the API.
    - `dataDictionary` string, string: URL to the data dictionary for the dataset or API. Note that documentation other than a data dictionary may be referenced in the Related Documents element.
    - `keyword` object[], nullable: Tags (or keywords) help users discover the dataset.
    - `modified` string, date-time, nullable: Indicates the most recent date on which the API endpoint or file format was changed, updated, or modified. This date has no bearing on the refresh cycle of the data. ISO 8601 date format.
    - `publisher` string, string: The publishing entity and optionally their parent organization(s).
    - `contactPoint` string, string: Contact person's name for the asset.
    - `mbox` string, string: Contact person's email address.
    - `accessLevel` string, string: The degree to which this dataset could be made publicly-available, regardless of whether it has been made available. Values: public (data asset is or could be made publicly available to all without restrictions), restricted public (data asset is available under certain use restrictions), or non-public (data asset is not available to members of the public).
    - `landingPage` string, string, nullable: Alternative landing page URL used to redirect user to a contextual, Agency-hosted 'homepage' for the dataset or API.
    - `temporal` string, string, nullable: The range of temporal applicability of a dataset (i.e., a start and end date of applicability for the data). ISO 8601 date interval format.
    - `api` boolean: True indicates the dataset part of the OpenFEMA API.
    - `version` number: Major version number of the dataset API endpoint. Version number does not change when additional fields are added to an existing dataset. Data type changes and field deletions will necessitate a version number change.
    - `recordCount` number, nullable: Count of the number of records within the dataset. Note, this should not be used to verify download integrity.
    - `bureauCode` object[]: FEMA's government defined bureau code.
    - `programCode` object[]: OpenFEMA's program code.
    - `accessLevelComment` string, string, nullable: NOT CURRENTLY IN USE. Includes information regarding access or restrictions based on privacy, security, or other policies. This should also serve as an explanation for the selected accessLevel including instructions for how to access a restricted file, if applicable, or explanation for why a non-public or restricted public data asset is not public, if applicable.
    - `license` string, string, nullable: NOT CURRENTLY IN USE. The license or non-license (i.e. Public Domain) status with which the dataset or API has been published. URL to the license.
    - `spatial` string, string, nullable: NOT CURRENTLY IN USE. The range of spatial applicability of a dataset. Could include a spatial region like a bounding box or a named place.
    - `theme` string, string: Main thematic category of the dataset.
    - `dataQuality` string, string: Whether the dataset meets the agencys Information Quality Guidelines (true/false).
    - `accrualPeriodicity` string, string: Update frequency expressed using the ISO 8601 Repeating Duration (R/PnYnMnWnDTnHnMnS syntax) standard to provide an unambiguous and well-defined method of representing time duration. Datasets having no set refresh interval will contain the value 'irregular'. See https://en.wikipedia.org/wiki/ISO_8601#Durations for details.
    - `language` string, string: The language of the dataset.
    - `primaryITInvestmentUII` string, string, nullable: NOT CURRENTLY IN USE. For linking a dataset with an IT Unique Investment Identifier (UII).
    - `references` object[], nullable: Additional references. Array of URL strings.
    - `issued` string, date-time: Date of initial dataset formal issuance or posting. ISO 8601 Date.
    - `systemOfRecords` string, string, nullable: NOT CURRENTLY IN USE. If the system is designated as a system of records under the Privacy Act of 1974, this is the URL to the System of Records Notice related to this dataset.
    - `depDate` string, date-time, nullable: Date when the API endpoint providing this dataset will no longer be accessible. ISO 8601 format.
    - `depApiMessage` string, string, nullable: Deprecation message that appears in the metadata section of the returned data set.
    - `depWebMessage` string, string, nullable: Deprecation details that are displayed on the OpenFEMA webpage.
    - `depNewURL` string, string, nullable: URL to the new API endpoint for this data set.
    - `lastRefresh` string, date-time: Date when the metadata record was last updated. Transitioned from being the last date the data set was updated in the data store. Note, in the short term the lastRefresh will be updated both when the metadata changes and when the data set is updated. However, if you use lastRefresh in an automated process to determine when to download data set updates, please begin using lastDataSetRefresh instead. ISO 8601 date format.
    - `lastDataSetRefresh` string, date-time: Last date the dataset was updated in the data store. ISO 8601 date format.
    - `hash` string, string: MD5 hash of fields and values of the record.
    - `id` string, string: Unique ID assigned to the record. It does not persist between data set refreshes.

---

[API](https://skmtc.dev/fema/apis/openfema-api.md) - [All operations](https://skmtc.dev/fema/apis/openfema-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fema/apis/openfema-api/revisions/fdc02603897f?raw)