> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/koala73/worldmonitor/llms.txt
> Use this file to discover all available pages before exploring further.

# Seismology Service

> Monitor earthquakes and seismic activity from USGS

## Overview

The Seismology Service provides APIs for earthquake monitoring data sourced from the United States Geological Survey (USGS). Access real-time seismic event data including magnitude, depth, location, and occurrence time.

**Base Path:** `/api/seismology/v1`

***

## ListEarthquakes

Retrieves recent earthquakes from the USGS GeoJSON feed.

**Endpoint:** `GET /api/seismology/v1/list-earthquakes`

### Request Parameters

<ParamField query="start" type="integer" required>
  Start of time range (inclusive), Unix epoch milliseconds.
</ParamField>

<ParamField query="end" type="integer" required>
  End of time range (inclusive), Unix epoch milliseconds.
</ParamField>

<ParamField query="page_size" type="integer">
  Maximum items per page (1-100).
</ParamField>

<ParamField query="cursor" type="string">
  Cursor for next page.
</ParamField>

<ParamField query="min_magnitude" type="number">
  Minimum magnitude filter (e.g., 4.0 for significant quakes).
</ParamField>

### Response

<ResponseField name="earthquakes" type="array">
  The list of earthquakes.

  <Expandable title="Earthquake">
    <ResponseField name="id" type="string" required>
      Unique USGS event identifier (e.g., "us7000abcd").
    </ResponseField>

    <ResponseField name="place" type="string">
      Human-readable place description (e.g., "10 km SW of Anchorage, Alaska").
    </ResponseField>

    <ResponseField name="magnitude" type="number">
      Earthquake magnitude on the Richter scale.
    </ResponseField>

    <ResponseField name="depth_km" type="number">
      Depth in kilometers below the surface.
    </ResponseField>

    <ResponseField name="location" type="object">
      Geographic location of the epicenter.

      <Expandable title="GeoCoordinates">
        <ResponseField name="latitude" type="number">
          Latitude coordinate.
        </ResponseField>

        <ResponseField name="longitude" type="number">
          Longitude coordinate.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="occurred_at" type="integer">
      Time the earthquake occurred, as Unix epoch milliseconds.
    </ResponseField>

    <ResponseField name="source_url" type="string">
      URL to the USGS event detail page.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata with cursor for next page.
</ResponseField>

### Example Request

```bash theme={null}
curl -X GET "https://api.worldmonitor.com/api/seismology/v1/list-earthquakes?start=1704067200000&end=1706745599999&min_magnitude=5.0&page_size=20"
```

### Example Response

```json theme={null}
{
  "earthquakes": [
    {
      "id": "us7000m9xa",
      "place": "52 km SSE of Amukta Island, Alaska",
      "magnitude": 5.8,
      "depth_km": 35.2,
      "location": {
        "latitude": 52.1234,
        "longitude": -171.5678
      },
      "occurred_at": 1705334400000,
      "source_url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000m9xa"
    },
    {
      "id": "us7000m9xb",
      "place": "15 km NW of Honshu, Japan",
      "magnitude": 6.2,
      "depth_km": 10.0,
      "location": {
        "latitude": 37.8912,
        "longitude": 138.2345
      },
      "occurred_at": 1705320000000,
      "source_url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000m9xb"
    },
    {
      "id": "us7000m9xc",
      "place": "Papua New Guinea region",
      "magnitude": 5.4,
      "depth_km": 55.8,
      "location": {
        "latitude": -5.4567,
        "longitude": 153.2345
      },
      "occurred_at": 1705305600000,
      "source_url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000m9xc"
    }
  ],
  "pagination": {
    "cursor": "eyJvZmZzZXQiOjIwfQ==",
    "has_more": true
  }
}
```

***

## Magnitude Scale Reference

<CardGroup cols={2}>
  <Card title="Minor (< 4.0)" icon="circle">
    Usually not felt, but can be recorded by seismographs.
  </Card>

  <Card title="Light (4.0 - 4.9)" icon="circle-dot">
    Often felt but rarely causes damage.
  </Card>

  <Card title="Moderate (5.0 - 5.9)" icon="circle-half-stroke">
    Can cause damage to poorly constructed buildings.
  </Card>

  <Card title="Strong (6.0 - 6.9)" icon="circle-exclamation">
    Can cause significant damage in populated areas.
  </Card>

  <Card title="Major (7.0 - 7.9)" icon="triangle-exclamation">
    Can cause serious damage over larger areas.
  </Card>

  <Card title="Great (8.0+)" icon="octagon-exclamation">
    Can cause devastating damage over very large areas.
  </Card>
</CardGroup>

***

## Data Source

Earthquake data is sourced from:

* **USGS**: United States Geological Survey
* **GeoJSON Feed**: Real-time earthquake data feed
* Updates every minute with new seismic events
* Global coverage with magnitude 2.5+ events
* Includes aftershocks and preliminary reports

***

## Use Cases

<AccordionGroup>
  <Accordion title="Disaster Response">
    Monitor seismic activity in real-time to coordinate emergency response efforts and assess infrastructure damage risk.
  </Accordion>

  <Accordion title="Risk Assessment">
    Analyze earthquake frequency and magnitude patterns to assess seismic risk for insurance, construction, and investment decisions.
  </Accordion>

  <Accordion title="Scientific Research">
    Access comprehensive seismic data for geological research, plate tectonics studies, and earthquake prediction models.
  </Accordion>

  <Accordion title="Infrastructure Monitoring">
    Track earthquakes near critical infrastructure such as nuclear facilities, dams, pipelines, and data centers.
  </Accordion>
</AccordionGroup>