U.S. flag

An official website of the United States government

Dot gov

Official websites use .gov

A .gov website belongs to an official government organization in the United States.

Https

Secure .gov websites use HTTPS

A lock ( ) or https:// means you’ve safely connected to the .gov website. Share sensitive information only on official, secure websites..

OpenFEMA Dataset: IPAWS Archived Alerts -- v1

Version: 1
Last Data Refresh: 11-13-2020
Entity Name IpawsArchivedAlerts
API Endpoint https://www.fema.gov/api/open/v1/IpawsArchivedAlerts
Update Frequency R/PT2M
Program URL https://www.fema.gov/emergency-managers/practitioners/integrated-public-alert-warning-system
Category Emergency Management/Preparedness/Alerts
Keywords IPAWS, alerts, cap, alert, warning, public alert
Deprecation Date 2020-10-01

Description

The Integrated Public Alert and Warning System (IPAWS) is a modernization of the nation's alert and warning infrastructure that unifies the United States' Emergency Alert System (EAS), Wireless Emergency Alerts (WEA), the National Oceanic and Atmospheric Administration (NOAA) Weather Radio, and other public alerting systems implemented as a set of Web services. IPAWS was designed to modernize these systems by enabling alerts to be aggregated over a network and distributed to the appropriate system for public dissemination.

Organized and managed by FEMA, the system supports alert origination by Federal, state, local, territorial and tribal officials, and subsequent dissemination to the public using a range of national and local alerting systems.

This data set contains recent*, historic, and archived IPAWS Common Alerting Protocol (CAP) v1.2 messages from June 2012 to the present including date, time, event code (examples listed below), city, county, joint agency, police, law enforcement, Collaborative Operating Group (COG), State(s), locality, territory or tribe. It can be used to capture and analyze historic and archived messages. *The dataset is published with a twenty four (24) hour delay to reduce the risk of being confused with an active alert received from the live IPAWS feed. The most recent record will reflect the alert(s) sent twenty four (24) hours ago (if such records exist). For example, if an alert originator sent an alert at 1459GMT on June 1st and sent a different alert at 1600GMT on June 2nd, these alerts will not be visible in the dataset until 1459GMT on June 2nd and 1600GMT June 3rd respectively. Information on signing up for receiving active alerts can be found at https://www.fema.gov/emergency-managers/practitioners/integrated-public-alert-warning-system. To request access to alerts issued through IPAWS or for a list of companies with access to the IPAWS All-Hazards Information Feed, email ipaws@fema.dhs.gov.

The data elements within the CAP messages are well documented and can be found in the following technical document: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

See also:

IPAWS Architecture - https://www.fema.gov/pdf/emergency/ipaws/architecture_diagram.pdf

IPAWS Overview - https://www.fema.gov/emergency-managers/practitioners/integrated-public-alert-warning-system

This is raw, unedited data with no personally identifiable information from the IPAWS Alert Aggregator from June 2012 to the present created by over 1450 Alert Originators across the country. FEMA does not validate the content of each message. As such, it may contain a small percentage of human error. The dataset is published with a twenty four (24) hour delay to reduce the risk of being confused with an active alert received from the live IPAWS feed. The most recent record will reflect the alert(s) sent twenty four (24) hours ago (if such records exist). For example, if an alert originator sent an alert at 1459GMT on June 1st and sent a different alert at 1600GMT on June 2nd, these alerts will not be visible in the dataset until 1459GMT on June 2nd and 1600GMT June 3rd respectively. OpenFEMA does not have a full backup capability so if the site goes down, you will not be able to access the information. This happens only on rare occasions.

Earlier messages may contain non-compliant geocoordinates which will not work if you try to use them. Recent versions of the software check these coordinates for compliance.

This dataset is not intended to be an official federal report, and should not be considered an official federal report. If you are using this site for other than research purposes, please understand that these CAP messages are captured only after the official IPAWS message has been sent. To request access to alerts issued through IPAWS or for a list of companies with access to the IPAWS All-Hazards Information Feed, email ipaws@fema.dhs.gov.

Note that the original IPAWS CAP message is provided in the originalMessage element of the returned JSON object. The XML based message is encoded such that a separate tool, such as a JSON parser, computer language, or browser must be used to view the original format. If no such tool is available to you, online utilities exist, such as https://codebeautify.org/json-escape-unescape that will decode the message. See the originalMessage field for additional details.

If you have media inquiries about this dataset please email the FEMA News Desk FEMA-News-Desk@dhs.gov or call (202) 646-3272. For inquiries about FEMA's data and Open government program please contact the OpenFEMA team via email OpenFEMA@fema.dhs.gov. IPAWS specific queries should be sent to the general mailbox (IPAWS@fema.dhs.gov). Copies will be sent from the mailbox to IPAWS leadership and Subject Matter Experts.

Full Data

Format Address Record Count Approximate File Size
json Link to json 3480146 large (500MB - 10GB)
jsona Link to jsona 3480146 large (500MB - 10GB)

Data Fields

Name Title Type Description Is Searchable
originalMessage Original XML Message
string

The container for all component parts of the alert XML message. Please note that the original XML message as delivered by the API in a JSON format contains encoded content. That is, certain characters, double quotes for example, are escaped such that the original format is preserved. This content can be decoded with JSON parsers, computer languages, and some web browsers to see the raw XML format. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

no
identifier Identifier
string

The identifier of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

yes
sender Sender
string

The identifier of the sender of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

yes
sent Sent Date
date

The time and date of the origination of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

yes
status Status
string

The code denoting the appropriate handling of the alert message. Code Values: Actual - Actionable by all targeted recipients; Exercise - Actionable only by designated exercise participants; exercise identifier SHOULD appear in ; System -For messages that support alert network internal functions. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

yes
msgType Message Type
string

The code denoting the nature of the alert message. Code Values: Alert -Initial information requiring attention by targeted recipients; Update -Updates and supersedes the earlier message(s) identified in ; Cancel - Cancels the earlier message(s) identified in ; Ack -Acknowledges receipt and acceptance of the message(s) identified in . For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

yes
source Source
string

The text identifying the source of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

yes
scope Scope
string

The code denoting the intended distribution of the alert message. Code Values: Public - For general dissemination to unrestricted audiences. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

yes
restriction Restriction
string

The text describing the rule for limiting distribution of the restricted alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

yes
addresses Addresses
string

The group listing of intended recipients of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

yes
code Code
string

The code denoting the special handling of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

no
note Note
string

The text describing the purpose or significance of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

no
incidents Incidents
string

The group listing naming the referent incident(s) of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

no
cogId COG ID
number

The COG Identifier Associated with the COG Profile

yes
info.language Info.Language
string

The code denoting the language of the info sub-element of the alert message

no
info.category Info.Category
string

The code from the element denoting the category associated with the subject event of the alert message (See CAPv1.2 standard for code values)

no
info.event Info.Event
string

The text from the element denoting the type of the subject event associated with the alert message

no
info.urgency Info.Urgency
string

The code from the element denoting the urgency associated with the subject event of the alert message (See CAPv1.2 standard for code values)

no
info.severity Info.Severity
string

The code from the element denoting the severity associated with the subject event of the alert message (See CAPv1.2 standard for code values)

no
info.certainty Info.Certainty
string

The code from the element denoting the certainty associated with the subject event of the alert message (See CAPv1.2 standard for code values)

no
info.audience Info.Audience
string

The text describing the intended audience of the alert message

no
info.effective Info.Effective
date

The effective time of the information of the alert message

yes
info.onset Info.Onset
date

The expected time of the beginning of the subject event of the alert message

no
info.expires Info.Expires
date

The expiry time of the information of the alert message

yes
info.senderName Info.SenderName
string

The text from the element naming the originator of the alert message

no
info.headline Info.Headline
string

The text headline from the element of the alert message. If the value for element is not included in the alert, the following text shall be persisted in the metadata record and returned in the message list: 'No Headline'

no
info.description Info.Description
string

The text describing the subject event of the alert message

no
info.instruction Info.Instruction
string

The text describing the recommended action to be taken by recipients of the alert message

no
info.web Info.Web
string

The identifier of the hyperlink associating additional information with the alert message

no
info.contact Info.Contact
string

The text describing the contact for follow-up and confirmation of the alert message

no
resource.resourceDesc Resource.Description
string

The text describing the type and content of the resource file

no
resource.mimeType Resource.MimeType
string

The identifier of the MIME content type and sub-type describing the resource file

no
resource.size Resource.Size
number

The integer indicating the size of the resource file. Approximate size of the resource file in bytes

no
resource.uri Resource.URI
string

The identifier of the hyperlink for the resource file

yes
resource.derefUri Resource.derefUri
string

Deference URI - file that is converted into machine readable, base 64 coding for image, or mp3 file

no
resource.digest Resource.Digest
string

The code representing the digital digest ('hash') computed from the resource file

no
references.sender References.Sender
string

The identifier of the sender of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

no
references.identifier References.Identifier
string

The identifier of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

no
references.sent References.Sent
date

The time and date of the origination of the alert message. For additional information on the metadata, please see the IPAWS Data Dictionary URL: https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

no
info.area.areaDesc Info.Area.AreaDesc
string

The text from the element describing the affected area of the alert message (See Note-2)

no
area.areaDesc Area.areaDesc
string

The text from the element describing the affected area of the alert message (See Note-2)

no
info.area.altitude Info.Area.Altitude
string

The specific or minimum altitude of the affected area of the alert message

no
area.altitude Area.Altitude
string

The specific or minimum altitude of the affected area of the alert message

no
info.area.ceiling Info.Area.Ceiling
string

The maximum altitude of the affected area of the alert message

no
area.ceiling Area.Ceiling
string

The maximum altitude of the affected area of the alert message

no
xmlns XML Name Space
string

Name space for the XML MessagE

no
id ID
string

Unique ID assigned to the record

yes

See Also

References

https://docs.oasis-open.org/emergency/cap/v1.2/CAP-v1.2-os.pdf

https://www.fema.gov/pdf/emergency/ipaws/architecture_diagram.pdf

Access the metadata API calls for additional information:

Last updated November 13, 2020