Requesting Historical Hazards

The endpoint for fetching historical hazards:

Query historical hazards

GET https://api-v2.disasteraware.com/historical_hazards

This endpoint allows you to search for historical hazards. You must supply a search term to this endpoint in order to limit the matches to be returned. There is a limit of 1000 matches which can be returned. This endpoint does not support paging.

In order to determine whether your request would return fewer than 1000 matches, it is recommended you use the hazards_count endpoint with the same exact search string. If it is a valid search, it will return the number of matches in the response.

The search term models a SQL query. See the where query parameter below for the fields which can be used in a query.

Query Parameters

Name	Type	Description
where*	string	A SQL-style query string to filter historical hazards. See below for available fields and examples.

Headers

Name	Type	Description
Authorization*	string	Authorize to access the API.

200

[
  {
    "app_ID": 0,
    "app_IDs": "",
    "autoexpire": "Y",
    "category_ID": "EVENT",
    "charter_Uri": "",
    "comment_Text": "{\"das\":true,\"properties\":{\"pixelCount\":65,\"radiance\":1638.83,\"timestamp\":1697220000}}",
    "create_Date": "1697156949919",
    "creator": "DisasterAWARE (Automated)",
    "end_Date": "1697317200000",
    "glide_Uri": "",
    "hazard_ID": 203575,
    "hazard_Name": "Wildfire - NW of Funchal, Madeira, Portugal",
    "last_Update": "1697317220456",
    "latitude": 32.79144554100003,
    "longitude": -17.196877677999964,
    "master_Incident_ID": "23938",
    "message_ID": "",
    "org_ID": -1,
    "severity_ID": "WARNING",
    "snc_url": "https://hazardbrief.pdc.org/PRODUCTION/ui/index.html?uuid=0f10d4de-6023-4a01-aecc-118146031cd0",
    "start_Date": "1697155200000",
    "status": "E",
    "type_ID": "WILDFIRE",
    "update_Date": "1697222134636",
    "update_User": "ddp",
    "product_total": "2",
    "uuid": "0f10d4de-6023-4a01-aecc-118146031cd0",
    "in_Dashboard": "0",
    "areabrief_url": null,
    "description": "Wildfire Information: Significant wildfire activity has been observed in NW of Funchal, Madeira, Portugal and detected at October 13, 2023 18:00 UTC. PDC categorizes the severity to be at WARNING level.  Based on preliminary analysis of recent satellite observations,it is estimated that 859 people, 333 households, and $286.62 Million (USD) of Infrastructure * are potentially affected. * The cost represents the total replacement value of the infrastructure. ",
    "roles": []
  }
]

200

See Authorizing Requests page to get your accessToken.

Checking Result Count

Before querying historical hazards, use the hazards_count endpoint to verify your search will return fewer than 1000 matches:

https://api-v2.disasteraware.com/hazards_count?where=<your_query>

Query Fields

The where parameter accepts the following fields:

Field	Description	Example
status	Hazard status. Use 'E' for expired hazards.	status = 'E'
type_id	Hazard type: AVALANCHE, TORNADO, WILDFIRE, etc.	type_id = 'AVALANCHE' OR type_id = 'WILDFIRE'
category_id	Hazard category: EVENT, EXERCISE, OTHER, RESPONSE	category_id = 'EVENT'
severity_id	Hazard severity: WARNING, WATCH, ADVISORY, INFORMATION	severity_id = 'WARNING'
hazard_name	Hazard name (use UPPER() and LIKE for case-insensitive search)	UPPER(hazard_name) LIKE '%HAWAII%'
comment_text	Any comment text associated with the hazard	UPPER(comment_text) LIKE '%TSUNAMI%'
create_date	Hazard creation date, typically used to check a range of dates	create_date >= to_date('2023-05-01 00:00:00', 'yyyy-mm-dd hh24:mi:ss') AND create_date <= to_date('2023-05-31 00:00:00', 'yyyy-mm-dd hh24:mi:ss')
latitude / longitude	Bounding box using latitude and longitude	(latitude >= 36.58 AND latitude <= 39.06) AND (longitude >= -123.99 AND longitude <= -119.68)

Examples

Filter by hazard type

?where=type_id = 'WILDFIRE'

Filter by multiple types

?where=type_id = 'AVALANCHE' OR type_id = 'WILDFIRE'

Search by hazard name (case-insensitive)

?where=UPPER(hazard_name) LIKE '%HAWAII%'

Filter by date range

?where=create_date >= to_date('2023-05-01 00:00:00', 'yyyy-mm-dd hh24:mi:ss') AND create_date <= to_date('2023-05-31 00:00:00', 'yyyy-mm-dd hh24:mi:ss')

Filter by geographic bounding box

?where=(latitude >= 36.58151 AND latitude <= 39.06433) AND (longitude >= -123.99719 AND longitude <= -119.68719)

Multi-field query

The following searches for expired WILDFIRE hazards of type EVENT, severity WARNING, created between 5/1/23 and 5/31/23, with "namefoo" (case-insensitive) in the hazard name and "commentfoo" (case-insensitive) in the comment text:

https://api-v2.disasteraware.com/hazards_count?where=((category_id = 'EVENT')) AND (UPPER(comment_text) LIKE '%COMMENTFOO%') AND (create_date >= to_date('2023-05-01 00:00:00', 'yyyy-mm-dd hh24:mi:ss') AND create_date <= to_date('2023-05-31 00:00:00', 'yyyy-mm-dd hh24:mi:ss')) AND (UPPER(hazard_name) LIKE '%NAMEFOO%') AND ((severity_id = 'WARNING')) AND ((status = 'E')) AND ((type_id = 'WILDFIRE'))

The multi-field example above uses the hazards_count endpoint to first verify the result count before fetching the actual hazards via historical_hazards.