U.S. Geological Survey · JSON Structure

Usgs Earthquake Api Earthquake Properties Structure

Properties of an earthquake event including magnitude, location, and metadata.

Type: object Properties: 22
Federal GovernmentGeologicalEarth ScienceNatural ResourcesEarthquakeWaterHydrology

EarthquakeProperties is a JSON Structure definition published by U.S. Geological Survey, describing 22 properties. It conforms to the https://json-structure.org/meta/core/v0/# meta-schema.

Properties

mag place time updated url detail felt cdi mmi alert status tsunami sig net code magType type title gap dmin rms nst

Meta-schema: https://json-structure.org/meta/core/v0/#

JSON Structure

Raw ↑
{
  "$schema": "https://json-structure.org/meta/core/v0/#",
  "$id": "https://raw.githubusercontent.com/api-evangelist/u-s-geological-survey/refs/heads/main/json-structure/usgs-earthquake-api-earthquake-properties-structure.json",
  "description": "Properties of an earthquake event including magnitude, location, and metadata.",
  "type": "object",
  "properties": {
    "mag": {
      "type": "double",
      "description": "Earthquake magnitude.",
      "example": 4.5
    },
    "place": {
      "type": "string",
      "description": "Textual description of the event location.",
      "example": "45 km NE of San Francisco, CA"
    },
    "time": {
      "type": "int32",
      "description": "Unix timestamp (milliseconds) of the earthquake occurrence.",
      "example": 1743840000000
    },
    "updated": {
      "type": "int32",
      "description": "Unix timestamp (milliseconds) of the last catalog update.",
      "example": 1743843600000
    },
    "url": {
      "type": "string",
      "description": "USGS event detail page URL.",
      "example": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000n5no"
    },
    "detail": {
      "type": "string",
      "description": "API URL for the full event GeoJSON.",
      "example": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=us7000n5no&format=geojson"
    },
    "felt": {
      "type": "int32",
      "description": "Number of DYFI (Did You Feel It?) responses.",
      "example": 23
    },
    "cdi": {
      "type": "double",
      "description": "Maximum Community Determined Intensity (CDI) value.",
      "example": 3.5
    },
    "mmi": {
      "type": "double",
      "description": "Maximum Modified Mercalli Intensity (MMI) from ShakeMap.",
      "example": 3.2
    },
    "alert": {
      "type": "string",
      "description": "PAGER alert level (green, yellow, orange, red).",
      "example": "green"
    },
    "status": {
      "type": "string",
      "description": "Review status (automatic or reviewed).",
      "example": "reviewed"
    },
    "tsunami": {
      "type": "int32",
      "description": "Tsunami hazard flag. 1 if tsunami warning was issued; 0 otherwise.",
      "example": 0
    },
    "sig": {
      "type": "int32",
      "description": "Significance value (0-1000) indicating event importance based on magnitude, MMI, felt reports, and estimated impact.",
      "example": 312
    },
    "net": {
      "type": "string",
      "description": "Network ID for the preferred source of event data.",
      "example": "us"
    },
    "code": {
      "type": "string",
      "description": "Event code assigned by the network.",
      "example": "7000n5no"
    },
    "magType": {
      "type": "string",
      "description": "Magnitude type (ml, md, mb, mw, mww, etc.).",
      "example": "mb"
    },
    "type": {
      "type": "string",
      "description": "Event type (earthquake, explosion, quarry blast, etc.).",
      "example": "earthquake"
    },
    "title": {
      "type": "string",
      "description": "Title string summarizing the event.",
      "example": "M 4.5 - 45 km NE of San Francisco, CA"
    },
    "gap": {
      "type": "double",
      "description": "Azimuthal gap in degrees between seismic stations.",
      "example": 78
    },
    "dmin": {
      "type": "double",
      "description": "Horizontal distance from epicenter to nearest station in degrees.",
      "example": 0.82
    },
    "rms": {
      "type": "double",
      "description": "Root-mean-square travel time residual in seconds.",
      "example": 0.45
    },
    "nst": {
      "type": "int32",
      "description": "Number of seismic stations used to determine earthquake location.",
      "example": 45
    }
  },
  "name": "EarthquakeProperties"
}