Requesting a Hazard
To request a single hazard by its identifier, use the route defined here:
Returns the complete V2 hazard record for the given uuid,
whether the hazard is active or historical. The shape matches the
sample pages and format=full on /historical-hazards-query, with
geometry inline. Records served from the historical archive
additionally carry legacy_hazard_id, location, and any
enhancement blocks.
A numeric value in the same path position is treated as a legacy
V1 hazard_ID and returns the V1-shaped record, wrapped in a
one-element array, as a compatibility passthrough for un-migrated
clients. Prefer uuid.
JWT access token obtained from POST /authorize. Tokens expire after
15 minutes.
The hazard uuid (recommended), or a legacy numeric hazard_ID.
c554507b-c769-43ab-8c67-07c116d4aa8cThe hazard. A V2 HazardRecord object for a uuid; a one-element
array of LegacyHazard for a numeric legacy id.
The value is neither a uuid nor a numeric legacy id.
Forbidden -- invalid or expired token.
No active or historical hazard with that uuid.
GET /hazards/{hazard-id} HTTP/1.1
Host: api-v2.disasteraware.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
"name": [
{
"locale": "en",
"value": "M 5.2 Earthquake - Southern Peru"
}
],
"description": [
{
"locale": "en",
"value": "M 5.2 Earthquake - Southern Peru"
}
],
"severity": "WARNING",
"category": "NATURAL",
"type": "EARTHQUAKE",
"uuid": "abc12345-6789-def0-1234-56789abcdef0",
"comment": "text",
"createdAt": 1697222149,
"updatedAt": 1697222149,
"startedAt": 1,
"endedAt": 1,
"latitude": -16.25,
"longitude": -71.58,
"version": 1,
"creator": "DisasterAWARE (Automated)",
"relatedHazards": [
{}
],
"incident": {
"uuid": "text",
"type": "text",
"sourceId": "text",
"sourceRecordId": "text",
"properties": {}
},
"source": {
"id": "text",
"name": "text",
"longName": "text",
"description": "text"
},
"alertGeometry": {
"type": "FeatureCollection",
"features": [
{}
]
},
"features": {
"type": "FeatureCollection",
"features": [
{}
]
},
"exposureAreas": {
"type": "FeatureCollection",
"features": [
{}
]
},
"exposureAssessment": {
"population": {
"total": 712000,
"total0_14": 125312,
"total15_64": 462515.2,
"total65_Plus": 124101.6,
"households": 285943.7751,
"vulnerable": 85400
},
"capital": {
"total": 76826932300,
"school": 418,
"hospital": 25
},
"foodNeeds": 1,
"waterNeeds": 1,
"wasteNeeds": 1,
"shelterNeeds": 1,
"foodNeedsUnit": "MRE",
"waterNeedsUnit": "gal",
"wasteNeedsUnit": "25 gal",
"shelterNeedsUnit": "sq feet",
"totalByCountry": [
{
"population": {
"total": 712000,
"total0_14": 125312,
"total15_64": 462515.2,
"total65_Plus": 124101.6,
"households": 285943.7751,
"vulnerable": 85400
},
"country": "PHL",
"capital": {
"total": 76826932300,
"school": 418,
"hospital": 25
},
"admin0": "Philippines",
"admin1": "Calabarzon",
"admin2": "Batangas",
"foodNeedsUnit": "MRE",
"foodNeeds": 1,
"waterNeedsUnit": "gal",
"waterNeeds": 1,
"wasteNeedsUnit": "25 gal",
"wasteNeeds": 1,
"shelterNeedsUnit": "sq feet",
"shelterNeeds": 1
}
],
"totalByAdmin": [
{
"population": {
"total": 712000,
"total0_14": 125312,
"total15_64": 462515.2,
"total65_Plus": 124101.6,
"households": 285943.7751,
"vulnerable": 85400
},
"country": "PHL",
"capital": {
"total": 76826932300,
"school": 418,
"hospital": 25
},
"admin0": "Philippines",
"admin1": "Calabarzon",
"admin2": "Batangas",
"foodNeedsUnit": "MRE",
"foodNeeds": 1,
"waterNeedsUnit": "gal",
"waterNeeds": 1,
"wasteNeedsUnit": "25 gal",
"wasteNeeds": 1,
"shelterNeedsUnit": "sq feet",
"shelterNeeds": 1
}
],
"exposureLevels": [
{
"level": "1",
"exposureDescription": "text",
"data": {
"population": {
"total": 712000,
"total0_14": 125312,
"total15_64": 462515.2,
"total65_Plus": 124101.6,
"households": 285943.7751,
"vulnerable": 85400
},
"capital": {
"total": 76826932300,
"school": 418,
"hospital": 25
},
"foodNeeds": 1,
"waterNeeds": 1,
"wasteNeeds": 1,
"shelterNeeds": 1,
"foodNeedsUnit": "text",
"waterNeedsUnit": "text",
"wasteNeedsUnit": "text",
"shelterNeedsUnit": "text",
"totalByCountry": [
{
"population": {
"total": 712000,
"total0_14": 125312,
"total15_64": 462515.2,
"total65_Plus": 124101.6,
"households": 285943.7751,
"vulnerable": 85400
},
"country": "PHL",
"capital": {
"total": 76826932300,
"school": 418,
"hospital": 25
},
"admin0": "Philippines",
"admin1": "Calabarzon",
"admin2": "Batangas",
"foodNeedsUnit": "MRE",
"foodNeeds": 1,
"waterNeedsUnit": "gal",
"waterNeeds": 1,
"wasteNeedsUnit": "25 gal",
"wasteNeeds": 1,
"shelterNeedsUnit": "sq feet",
"shelterNeeds": 1
}
],
"totalByAdmin": [
{
"population": {
"total": 712000,
"total0_14": 125312,
"total15_64": 462515.2,
"total65_Plus": 124101.6,
"households": 285943.7751,
"vulnerable": 85400
},
"country": "PHL",
"capital": {
"total": 76826932300,
"school": 418,
"hospital": 25
},
"admin0": "Philippines",
"admin1": "Calabarzon",
"admin2": "Batangas",
"foodNeedsUnit": "MRE",
"foodNeeds": 1,
"waterNeedsUnit": "gal",
"waterNeeds": 1,
"wasteNeedsUnit": "25 gal",
"wasteNeeds": 1,
"shelterNeedsUnit": "sq feet",
"shelterNeeds": 1
}
]
}
}
],
"exposureDescription": "text",
"timestamp": 1,
"hazardUuid": "text",
"hazardType": "text",
"version": 1
},
"legacy_hazard_id": 471892,
"location": {
"location_type": "land",
"geocode_fallback": true,
"source": "arcgis_reverse_geocoder",
"admin0": "United States of America",
"admin0_iso2": "US",
"admin0_iso3": "USA",
"admin1": "Missouri",
"admin1_code": "US-MO",
"admin2": "Ste. Genevieve",
"admin2_code": "29186",
"continent": "North America",
"subregion": "Northern America",
"nearest_country_code": "text",
"nearest_admin1": "text",
"nearest_place": "text"
},
"earthquakeAssessment": {},
"cycloneAssessment": {},
"cycloneDetails": {},
"tornadoAssessment": {},
"tornadoDetails": {},
"hailAssessment": {},
"hailDetails": {},
"windAssessment": {},
"windDetails": {},
"scsClassification": {},
"floodAssessment": {},
"floodDetails": {}
}Identifying the hazard
Every V2 hazard payload carries a uuid. Pass that value in the path to get the complete V2 hazard record back — the same shape as the hazard sample pages, with alertGeometry, features, exposureAreas, and exposureAssessment inline. This works whether the hazard is currently active or has already moved to the historical archive, so a uuid you captured from /active-hazards-query remains resolvable after the hazard expires.
Records served from the historical archive additionally carry three fields that active records do not: legacy_hazard_id (the hazard's V1 numeric id), location (a reverse-geocoded administrative block), and any enhancement blocks such as earthquakeAssessment or cycloneAssessment. These are described in Requesting Historical Hazards.
Legacy numeric ids
A numeric value in the same path position is treated as a legacy V1 hazard_ID:
This is a compatibility passthrough for clients that have not migrated to uuid. It returns the V1-shaped record — snake_Case keys such as hazard_ID, type_ID, and create_Date, with epoch-millisecond string timestamps — wrapped in a one-element array. It does not include the V2 incident, alertGeometry, features, or exposure blocks.
Responses
200
The hazard. A single V2 object for a uuid; a one-element array of the V1 record for a numeric id.
400
The path value is neither a uuid nor a number. Body: {"error": "Invalid hazard identifier", "message": "Expected a V2 uuid (or a legacy numeric hazard_ID)."}
404
No active or historical hazard has that uuid. Body: {"error": "Hazard not found", "message": "No active or historical hazard with uuid <uuid>."}
403
Invalid or expired token.
Example
Unlike the query endpoints, this endpoint returns the record inline as JSON — there is no redirect and no compression.
Last updated