GetEarthquakeProbability API

For a specified location, the GetEarthquakeProbability API returns:

  1. The latitude and longitude of the location.

  2. The current expected rate of earthquakes of specified magnitude over a specified time window.

  3. The current expected probability of experiencing at least one such earthquake.

The GetEarthquakeProbability Web Service is located at:

The parameters of the API are:

q The geographical location to query.  This can be a city name, street address, etc.  The parameter type is a text string.
w The calculation window (in days) for the forecast. The parameter type is an integer.  Default value: 365 (1 year).
The magnitude threshold for the forecast. The parameter type is a float.  Default value: 6.0. No
The calculation radius (in km) for the forecast. The parameter type is an integer.  Default value: 50 (approximately 31 miles) . No

The results returned by the API are:


The resulting parsed location for the calculation:

  • place
  • lat
  • lng
  • radius

The calculation results:

  • window
  • mag
  • rate
  • prob

Messages and Codes:

The following table summarizes possible return codes from the API:

Error CodeDescriptionResolution
0 No location was specified
Check if you have provided a geographical location in your API call.
1 Location could not be found Check the provided geographical location for spelling mistakes.


The following request will return the probability of a magnitude 6.8 earthquake occurring within 100km of San Francisco over the next 365 days.



        <place>San Francisco, CA, USA</place>
        <radius unit="km">100.000000</radius>
        <window unit="days">365</window>
Risk Alert