Main Content

OpenFEMA Dataset: IPAWS Archived Alerts V1


This page documents the metadata for the IPAWS Alerts Repository Pulled from The Common Alerting Protocol (CAP) Aggregator (CAPv1.2) API data feed.

Entity Name

IpawsArchivedAlerts

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/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/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.

Version:

1

Program URL

https://www.fema.gov/integrated-public-alert-warning-system

Contact

OpenFEMA - openfema@fema.gov

API Endpoint

https://www.fema.gov/api/open/v1/IpawsArchivedAlerts

Full Data

Format

Address

N/A

There are no full download links for this data set.

Keywords

IPAWS, alerts, cap, alert, warning, public alert

Data Fields

Data Fields
NameTitleTypeDescription

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

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

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

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

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

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

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

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

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

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

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

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

searchGeometry

Search Geometry

GeoJSON

This field includes the GeoJSON of all of the well-formed geometries found in the info.area fields (polygon and circle). This field is included to facilitate geospatial queries to find alerts

References

References

references[]

The group listing identifying earlier message(s) referenced by 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

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

Info

Information

Info[]

The container for all component parts of the info sub-element of the alert message as an array. 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

cogId

COG ID

number

The COG Identifier Associated with the COG Profile

info.language

Info.Language

string

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

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)

info.event

Info.Event

string

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

info.responseType

Info.ResponseType

string

The code from the element denoting the type of action for the target audience for the alert message (See CAPv1.2 standard for code values)

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)

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)

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)

info.audience

Info.Audience

string

The text describing the intended audience of the alert message

info.eventCode

Info.EventCode

any[]

The code from the element identifying the event type of the alert message. The data is transformed from the original format of valueName value {valueName: value} to better align with JSON structures. 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

info.effective

Info.Effective

date

The effective time of the information of the alert message

info.onset

Info.Onset

date

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

info.expires

Info.Expires

date

The expiry time of the information of the alert message

info.senderName

Info.SenderName

string

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

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'

info.description

Info.Description

string

The text describing the subject event of the alert message

info.instruction

Info.Instruction

string

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

info.web

Info.Web

string

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

info.contact

Info.Contact

string

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

info.parameter

Info.Parameter

object[]

A system specific additional parameter associated with the alert message. The data is transformed from the original format of valueName value {valueName: value} to better align with JSON structures. 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

eventCode

Event Code

array

This field includes all of the event Codes from each of the info objects contained in the alert. Each info object still maintains its own event codes. This is used to facilitate searches for any alerts that may contain a specific eventCode. The code from the element identifying the event type of the alert message. The data is transformed from the original format of valueName value {valueName: value} to better align with JSON structures. 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

info.resource

Info.Resource

resource[]

The container for all component parts of the resource sub-element of the info sub-element of the alert element

resource.resourceDesc

Resource.Description

string

The text describing the type and content of the resource file

resource.mimeType

Resource.MimeType

string

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

resource.size

Resource.Size

number

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

resource.uri

Resource.URI

string

The identifier of the hyperlink for the resource file

resource.derefUri

Resource.derefUri

string

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

resource.digest

Resource.Digest

string

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

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

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

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

info.area

Info.Area

area[]

The container for all component parts of the area sub-element of the info sub-element of the alert message

area.areaDesc

Area.areaDesc

string

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

area.polygon

Area.Polygon

GeoJSON

The paired value of points defining a polygon that delineates the affected area of the alert message. A value shall be persisted in a single metadata record as a Boolean (Metadata value shall be 'Y' or 'N'), indicating the existence or non-existence of polygon data. 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

area.circle

Area.Circle

GeoJSON

The paired value of a point and radius defining a circle that delineates the affected area of the alert message. A value shall be persisted in a single metadata record as a Boolean (Metadata value shall be 'Y' or 'N'), indicating the existence or non-existence of circle data. 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

area.geocode

Area.Geocode

object[]

The geographic code in the element delineating the affected area of alert message. The data is transformed from the original format of valueName value {valueName: value} to better align with JSON structures. 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

area.altitude

Area.Altitude

string

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

area.ceiling

Area.Ceiling

string

The maximum altitude of the affected area of the alert message

Id

ID

string

Unique ID assigned to the record

 

Last Updated: 
06/16/2020 - 13:54