ASCE Hazard Tool API documentation

What can you do with the ASCE Hazard Tool API?

The ASCE Hazard Tool API currently provides the following data for any location in the contiguous United States (lower 48), Alaska, Hawaii, Puerto Rico, Guam, American Samoa, and the U.S. Virgin Islands.

• ASCE 7-22 wind, ice, rain, flood, seismic, snow, tornado, tsunami data
• ASCE 7-16 wind, ice, rain, flood, seismic, snow, tsunami data
• ASCE 7-10 wind, ice, rain, flood, seismic, snow, tsunami data
• ASCE 41-17 seismic data

Audience

This document is for website and mobile developers who want to use ASCE Hazard data within their own web based or mobile applications. It introduces using the API and reference material on the available parameters.

API Key

All ASCE Hazard Tool API requests need to authenticate with an API key. All keys are managed through the ASCE Hazard Tool Account Manager. At the time of sign up, your company will receive the API key. If you need a higher usage limit, please contact us to make special arrangements.

Sample API Key: 957f4961-5bb3-4c93-a8c2-acfdcdb0b9f3

If you have any questions or concerns about your API key, please contact [email protected].

Documentation

A site for constructing and testing API calls is available at https://api-hazard.asce.org/docs.

Error Codes

Failing requests will return an error code and message.

• Code 200: the API request was successful
• Code 400: invalid input
• Code 500: missing or invalid key
• Code 500: over query limit 

Output

API output is in JSON format. See below for the response to a sample query.

View the complete documentation for the relevant JSON fields for all hazards (PDF). 

{
  "requestInfo": {
    "url": "http://localhost:8080/v1/snow?lat=34.921206&lon=-118.418998&standardsVersion=7- 
22&riskLevel=3&token=f7b3e3e3-3e3e-3e3e-3e3e-3e3e3e3e3e3f",
    "start": "04/30/2024 18:40:00.728",
    "end": "04/30/2024 18:40:19.417",
    "duration": "18.6 seconds",
    "currentMonthlyRequestNumber": "69/1000"
  },
  "snow": {
    "noSnowFeatures": false,
    "isNewHampshire_7_16": false,
    "state": "California",
    "snowResults": [
      {
        "key": "mri20yr",
        "value": "12.4404"
      },
      {
        "key": "elevation",
        "value": "1045.11"
      },
      {
        "key": "winterWind",
        "value": 0.35
      },
      {
        "key": "alaska",
        "value": null
      },
      {
        "key": "riskCategory3",
        "value": "40.8318"
      }
    ]
  }
}