### GET /fdsnws/event/1/query

Source: https://earthquake.usgs.gov/fdsnws/event/1/query_endtime=2014-01-02&format=geojson&starttime=2014-01-01

Retrieve earthquake data based on specified criteria. Parameters include starttime, endtime, format, and more.

```APIDOC
## GET /fdsnws/event/1/query

### Description
Retrieve earthquake data based on specified criteria. Parameters include starttime, endtime, format, and more.

### Method
GET

### Endpoint
https://earthquake.usgs.gov/fdsnws/event/1/query

### Parameters
#### Query Parameters
- **starttime** (string) - Required - The start of the time range to search for earthquakes. Format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS.sssZ
- **endtime** (string) - Required - The end of the time range to search for earthquakes. Format: YYYY-MM-DD or YYYY-MM-DDTHH:MM:SS.sssZ
- **format** (string) - Optional - The desired output format. Supported formats include geojson, csv, and text.
- **minmagnitude** (number) - Optional - The minimum magnitude of earthquakes to retrieve.
- **maxmagnitude** (number) - Optional - The maximum magnitude of earthquakes to retrieve.
- **latitude** (number) - Optional - The latitude to center the search around.
- **longitude** (number) - Optional - The longitude to center the search around.
- **maxradiuskm** (number) - Optional - The maximum radius (in kilometers) to search around the specified latitude and longitude.

### Request Example
```
https://earthquake.usgs.gov/fdsnws/event/1/query?starttime=2014-01-01&endtime=2014-01-02&format=geojson
```

### Response
#### Success Response (200)
- **type** (string) - The type of the GeoJSON object (e.g., "FeatureCollection").
- **metadata** (object) - Metadata about the request and the data.
- **features** (array) - An array of earthquake features.
  - **type** (string) - The type of the GeoJSON feature (e.g., "Feature").
  - **properties** (object) - Properties of the earthquake (mag, place, time, url, etc.).
  - **geometry** (object) - Geometric information about the earthquake (type and coordinates).
  - **id** (string) - Unique identifier for the earthquake.

#### Response Example
```json
{
  "type": "FeatureCollection",
  "metadata": {
    "generated": 1764382395000,
    "url": "https://earthquake.usgs.gov/fdsnws/event/1/query?endtime=2014-01-02&format=geojson&starttime=2014-01-01",
    "title": "USGS Earthquakes",
    "status": 200,
    "api": "1.14.1",
    "count": 325
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "mag": 1.29,
        "place": "10km SSW of Idyllwild, CA",
        "time": 1388620296020,
        "updated": 1457728844428,
        "tz": null,
        "url": "https://earthquake.usgs.gov/earthquakes/eventpage/ci11408890",
        "detail": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=ci11408890&format=geojson",
        "felt": null,
        "cdi": null,
        "mmi": null,
        "alert": null,
        "status": "reviewed",
        "tsunami": 0,
        "sig": 26,
        "net": "ci",
        "code": "11408890",
        "ids": ",ci11408890,",
        "sources": ",ci,",
        "types": ",cap,focal-mechanism,nearby-cities,origin,phase-data,scitech-link,",
        "nst": 39,
        "dmin": 0.06729,
        "rms": 0.09,
        "gap": 51,
        "magType": "ml",
        "type": "earthquake",
        "title": "M 1.3 - 10km SSW of Idyllwild, CA"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -116.7776667,
          33.6633333,
          11.008
        ]
      },
      "id": "ci11408890"
    }
  ]
}
```
```

--------------------------------

### GET /fdsnws/event/1/query

Source: https://earthquake.usgs.gov/fdsnws/event/1/index

Submits a data request for earthquake events using various query parameters. Supports multiple output formats including GeoJSON, KML, text, and QuakeML.

```APIDOC
## GET /fdsnws/event/1/query

### Description
This endpoint allows you to submit a data request for earthquake events. You can specify a wide range of parameters to filter your search. The results can be returned in various formats.

### Method
GET

### Endpoint
`https://earthquake.usgs.gov/fdsnws/event/1/query`

### Query Parameters
* **format** (String) - Optional - Default: `quakeml` - Specify the output format. Supported formats: `csv`, `geojson`, `kml`, `quakeml` (alias for `xml`), `text`, `xml`.
    * `format=geojson`: Additional parameters `callback`, `jsonerror` can be specified.
    * `format=kml`: Additional parameters `kmlanimated`, `kmlcolorby` can be specified.
    * `format=text`: Available only for `count`, `query`, and `version` methods.
    * `format=xml` (`method=query`): Response format is QuakeML 1.2. Mime-type is `application/xml`.
* **starttime** (String) - Optional - Default: `NOW - 30 days` - Limit to events on or after the specified start time (ISO8601 format).
* **endtime** (String) - Optional - Default: `present time` - Limit to events on or before the specified end time (ISO8601 format).
* **updatedafter** (String) - Optional - Default: `null` - Limit to events updated after the specified time (ISO8601 format).
* **minmagnitude** (Number) - Optional - Minimum magnitude of the earthquakes to include.
* **maxmagnitude** (Number) - Optional - Maximum magnitude of the earthquakes to include.
* **mindepth** (Number) - Optional - Minimum depth of the earthquakes to include.
* **maxdepth** (Number) - Optional - Maximum depth of the earthquakes to include.
* **latitude** (Number) - Optional - Latitude for a circular search.
* **longitude** (Number) - Optional - Longitude for a circular search.
* **maxradiuskm** (Number) - Optional - Maximum radius in kilometers for a circular search.
* **minradiuskm** (Number) - Optional - Minimum radius in kilometers for a circular search.
* **lat1** (Number) - Optional - Latitude of the first corner of a rectangular search.
* **lon1** (Number) - Optional - Longitude of the first corner of a rectangular search.
* **lat2** (Number) - Optional - Latitude of the second corner of a rectangular search.
* **lon2** (Number) - Optional - Longitude of the second corner of a rectangular search.
* **mincdi** (Number) - Optional - Minimum certainty of displacement.
* **maxcdi** (Number) - Optional - Maximum certainty of displacement.
* **minfelt** (Number) - Optional - Minimum number of people who felt the event.
* **maxfelt** (Number) - Optional - Maximum number of people who felt the event.
* **minsignificant** (Number) - Optional - Minimum significance value.
* **maxsignificant** (Number) - Optional - Maximum significance value.
* **mindistancekm** (Number) - Optional - Minimum distance in kilometers from the epicenter.
* **maxdistancekm** (Number) - Optional - Maximum distance in kilometers from the epicenter.
* **producttype** (String) - Optional - Filter by product type (e.g., 'Significant', 'Mmi', 'Shakemap').
* **eventid** (String) - Optional - Filter by a specific event ID.
* **eventtype** (String) - Optional - Filter by event type (e.g., 'earthquake', 'explosion').
* **includedeleted** (Boolean) - Optional - Whether to include deleted events.

### Request Example
```
https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&starttime=2014-01-01&endtime=2014-01-02
https://earthquake.usgs.gov/fdsnws/event/1/query?format=xml&starttime=2014-01-01&endtime=2014-01-02&minmagnitude=5
```

### Response
#### Success Response (200)
* **Event Data** (Object/String) - The earthquake event data, formatted according to the `format` parameter. For `format=geojson`, it will be a GeoJSON FeatureCollection. For `format=xml` (or `quakeml`), it will be in QuakeML 1.2 format.
```

--------------------------------

### GET /fdsnws/event/1/query

Source: https://earthquake.usgs.gov/fdsnws/event/1/query_endtime=2014-01-02&format=xml&minmagnitude=5&starttime=2014-01-01

Retrieves earthquake event data based on specified criteria. This endpoint allows filtering by time, magnitude, location, and more.

```APIDOC
## GET /fdsnws/event/1/query

### Description
Retrieves earthquake event data based on specified criteria. This endpoint allows filtering by time, magnitude, location, and more.

### Method
GET

### Endpoint
/fdsnws/event/1/query

### Parameters
#### Query Parameters
- **starttime** (string) - Required - The start of the time window for the query (e.g., "2014-01-01").
- **endtime** (string) - Required - The end of the time window for the query (e.g., "2014-01-02").
- **minmagnitude** (number) - Optional - The minimum magnitude to include in the results (e.g., "5").
- **format** (string) - Optional - The desired output format (e.g., "xml", "geojson"). Defaults to "xml".
- **eventid** (string) - Optional - A specific event ID to retrieve.

### Request Example
```
GET /fdsnws/event/1/query?starttime=2014-01-01&endtime=2014-01-02&minmagnitude=5&format=xml
```

### Response
#### Success Response (200)
- **eventParameters** (object) - Contains a list of earthquake events matching the query.
  - **event** (array) - An array of event objects.
    - **description** (object)
      - **type** (string) - Type of description (e.g., "earthquake name").
      - **text** (string) - Textual description of the event (e.g., "32 km W of Sola, Vanuatu").
    - **origin** (object)
      - **time** (object)
        - **value** (string) - The origin time of the earthquake (ISO 8601 format).
      - **longitude** (object)
        - **value** (number) - The longitude of the earthquake epicenter.
      - **latitude** (object)
        - **value** (number) - The latitude of the earthquake epicenter.
      - **depth** (object)
        - **value** (number) - The depth of the earthquake in meters.
      - **evaluationMode** (string) - The mode of evaluation (e.g., "manual").
      - **creationInfo** (object)
        - **agencyID** (string) - The ID of the agency that created the record.
        - **creationTime** (string) - The time the record was created.
    - **magnitude** (object)
      - **mag** (object)
        - **value** (number) - The magnitude value.
      - **type** (string) - The type of magnitude (e.g., "mww").
      - **originID** (string) - The ID of the origin associated with this magnitude.
      - **evaluationMode** (string) - The mode of evaluation.
      - **creationInfo** (object)
        - **agencyID** (string) - The ID of the agency that created the record.
        - **creationTime** (string) - The time the record was created.

#### Response Example
```json
{
  "eventParameters": {
    "event": [
      {
        "description": {
          "type": "earthquake name",
          "text": "32 km W of Sola, Vanuatu"
        },
        "origin": {
          "time": {
            "value": "2014-01-01T16:03:29.000Z"
          },
          "longitude": {
            "value": 167.249
          },
          "latitude": {
            "value": -13.8633
          },
          "depth": {
            "value": 187000,
            "uncertainty": 1700
          },
          "evaluationMode": "manual",
          "creationInfo": {
            "agencyID": "us",
            "creationTime": "2014-03-07T00:25:54.000Z"
          }
        },
        "magnitude": {
          "mag": {
            "value": 6.5
          },
          "type": "mww",
          "originID": "quakeml:earthquake.usgs.gov/product/origin/usc000lvb5/us/1394151954000/product.xml",
          "evaluationMode": "manual",
          "creationInfo": {
            "agencyID": "us",
            "creationTime": "2014-03-07T00:25:54.000Z"
          }
        }
      }
    ]
  }
}
```
```

--------------------------------

### GET /fdsnws/event/1/count

Source: https://earthquake.usgs.gov/fdsnws/event/1/index

Performs a count on earthquake data based on specified parameters. Supports plain text, GeoJSON, and XML output formats.

```APIDOC
## GET /fdsnws/event/1/count

### Description
This endpoint performs a count on earthquake data matching the provided query parameters. The result can be returned in plain text, GeoJSON, or XML format.

### Method
GET

### Endpoint
`https://earthquake.usgs.gov/fdsnws/event/1/count`

### Query Parameters
* **format** (String) - Optional - Default: `quakeml` - Specify the output format. Supported formats: `csv`, `geojson`, `kml`, `quakeml` (alias for `xml`), `text`, `xml`.
* **starttime** (String) - Optional - Default: `NOW - 30 days` - Limit to events on or after the specified start time (ISO8601 format).
* **endtime** (String) - Optional - Default: `present time` - Limit to events on or before the specified end time (ISO8601 format).
* **updatedafter** (String) - Optional - Default: `null` - Limit to events updated after the specified time (ISO8601 format).

### Request Example
```
https://earthquake.usgs.gov/fdsnws/event/1/count?format=geojson&starttime=2014-01-01&endtime=2014-01-02
```

### Response
#### Success Response (200)
* **Count** (Integer/Object) - The number of matching earthquake events. The structure depends on the `format` parameter.
```

--------------------------------

### FDSN Event Web Service - General Information

Source: https://earthquake.usgs.gov/fdsnws/event/1/index

Provides access to general information about the FDSN Event Web Service, including application details and service version.

```APIDOC
## General Information

### Description
This section provides access to general metadata and configuration information for the FDSN Event Web Service.

### Methods

#### `application.json`
* **Description**: Request known enumerated parameter values for the interface in JSON format.
* **Endpoint**: `https://earthquake.usgs.gov/fdsnws/event/1/application.json`

#### `application.wadl`
* **Description**: Request the Web Application Description Language (WADL) for the interface.
* **Endpoint**: `https://earthquake.usgs.gov/fdsnws/event/1/application.wadl`

#### `version`
* **Description**: Request the full service version number.
* **Endpoint**: `https://earthquake.usgs.gov/fdsnws/event/1/version`
```

--------------------------------

### FDSN Event Web Service - Catalogs and Contributors

Source: https://earthquake.usgs.gov/fdsnws/event/1/index

Retrieves lists of available earthquake catalogs and contributors recognized by the FDSN Event Web Service.

```APIDOC
## Catalogs and Contributors

### Description
This section allows you to retrieve lists of available earthquake catalogs and the contributors associated with them.

### Methods

#### `catalogs`
* **Description**: Request available earthquake catalogs.
* **Endpoint**: `https://earthquake.usgs.gov/fdsnws/event/1/catalogs`

#### `contributors`
* **Description**: Request available contributors to the earthquake data.
* **Endpoint**: `https://earthquake.usgs.gov/fdsnws/event/1/contributors`
```

--------------------------------

### Event Query Parameters

Source: https://earthquake.usgs.gov/fdsnws/event/1/index

This section details the various query parameters available for filtering and customizing earthquake event data requests.

```APIDOC
## GET /event

### Description
This endpoint allows users to query earthquake events with a wide range of filtering and formatting options.

### Method
GET

### Endpoint
/event

### Parameters
#### Query Parameters
- **alertlevel** (String) - Optional - Limit to events with a specific PAGER alert level. Allowed values: `green`, `yellow`, `orange`, `red`.
- **callback** (String) - Optional - Convert GeoJSON output to a JSONP response using this callback. Mime-type is “text/javascript”. Callback values are restricted to the characters `[A-Za-z0-9\._]+`. NOTE: Must be used with `format=geojson`.
- **eventtype** (String) - Optional - Limit to events of a specific type. NOTE: `earthquake` will filter non-earthquake events.
- **jsonerror** (Boolean) - Optional - Request JSON(P) formatted output even on API error results. NOTE: Must be used with `format=geojson`. Defaults to `false`.
- **kmlanimated** (Boolean) - Optional - Whether to include timestamp in generated KML, for Google Earth animation support. NOTE: Must be used with `format=kml`. Defaults to `false`.
- **kmlcolorby** (String) - Optional - How earthquakes are colored in KML. Accepted values: `age`, `depth`. NOTE: Must be used with `format=kml`.
- **maxcdi** (Decimal) - Optional - Maximum value for Maximum Community Determined Intensity reported by DYFI. Range: [0, 12].
- **maxgap** (Decimal) - Optional - Limit to events with no more than this azimuthal gap (in degrees). Range: [0, 360].
- **maxmmi** (Decimal) - Optional - Maximum value for Maximum Modified Mercalli Intensity reported by ShakeMap. Range: [0, 12].
- **maxsig** (Integer) - Optional - Limit to events with no more than this significance.
- **mincdi** (Decimal) - Optional - Minimum value for Maximum Community Determined Intensity reported by DYFI.
- **minfelt** (Integer) - Optional - Limit to events with at least this many DYFI responses. Minimum value: 1.
- **mingap** (Decimal) - Optional - Limit to events with no less than this azimuthal gap (in degrees). Range: [0, 360].
- **minsig** (Integer) - Optional - Limit to events with no less than this significance.
- **nodata** (Integer) - Optional - Define the error code returned when no data is found. Accepted values: `204`, `404`. Defaults to `204`.
- **producttype** (String) - Optional - Limit to events that have a specific product type associated. Example producttypes: `moment-tensor`, `focal-mechanism`, `shakemap`, `losspager`, `dyfi`.
- **productcode** (String) - Optional - Return the event associated with the specified product code. The event will be returned even if the product code is not the preferred code for the event. Example productcodes: `nn00458749`, `at00ndf1fr`.
- **reviewstatus** (String) - Optional - Limit to events with a specific review status. Allowed values: `automatic`, `reviewed`, `all`. Defaults to `all`.

### Request Example
```http
GET /event?minmagnitude=5&alertlevel=red&format=geojson
```

### Response
#### Success Response (200)
- **data** (Object) - Contains the earthquake event data based on the query parameters.

#### Response Example
```json
{
  "type": "FeatureCollection",
  "metadata": {
    "generated": 1678886400000,
    "url": "https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&limit=10&minmagnitude=5",
    "title": "USGS Magnitude 5+ Earthquakes",
    "status": 200,
    "api": "1.17.0",
    "offset": 0,
    "count": 10
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "mag": 6.2,
        "place": "97 km SW of Nyamata, Rwanda",
        "time": 1678877419070,
        "updated": 1678913636010,
        "tz": 120000,
        "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000k4s6-2",
        "detail": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=us7000k4s6",
        "status": "reviewed",
        "Вопрос": "PAGER",
        "felt": 1,
        "cdi": 2.3,
        "mmi": 4.707,
        "alert": "green",
        "sig": 816,
        "rms": 0.36,
        "Вопрос": 0.022,
        "Вопрос": 0.011,
        "Вопрос": "2023-03-15T12:10:19.070Z",
        "Вопрос": "2023-03-15T21:33:56.010Z",
        "Вопрос": {
          "Вопрос": "us7000k4s6"
        },
        "Вопрос": {
          "Вопрос": "geofon",
          "Вопрос": "gfz",
          "Вопрос": "isc",
          "Вопрос": "neic"
        }
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          29.5431,
          -2.7783,
          10.0
        ]
      },
      "id": "us7000k4s6"
    }
    // ... more features
  ]
}
```
```

--------------------------------

### Query Earthquake Events

Source: https://earthquake.usgs.gov/fdsnws/event/1/index

Retrieve earthquake event data by specifying various filtering parameters. This endpoint allows for granular control over the search results.

```APIDOC
## GET /event

### Description
Retrieve earthquake event data by specifying various filtering parameters. This endpoint allows for granular control over the search results.

### Method
GET

### Endpoint
/event

### Parameters
#### Query Parameters
- **catalog** (String) - Optional - Limit to events from a specified catalog. Use the Catalogs Method to find available catalogs. NOTE: when catalog and contributor are omitted, the most preferred information from any catalog or contributor for the event is returned.
- **contributor** (String) - Optional - Limit to events contributed by a specified contributor. Use the Contributors Method to find available contributors. NOTE: when catalog and contributor are omitted, the most preferred information from any catalog or contributor for the event is returned.
- **eventid** (String) - Optional - Select a specific event by ID; event identifiers are data center specific. NOTE: Selecting a specific event implies includeallorigins, includeallmagnitudes, and, additionally, associated moment tensor and focal-mechanisms are included.
- **includeallmagnitudes** (Boolean) - Optional - Specify if all magnitudes for the event should be included, default is data center dependent but is suggested to be the preferred magnitude only. NOTE: because magnitudes and origins are strongly associated, this parameter is interchangeable with includeallmagnitudes
- **includeallorigins** (Boolean) - Optional - Specify if all origins for the event should be included, default is data center dependent but is suggested to be the preferred origin only. NOTE: because magnitudes and origins are strongly associated, this parameter is interchangeable with includeallmagnitudes
- **includearrivals** (Boolean) - Optional - Specify if phase arrivals should be included. NOTE: NOT CURRENTLY IMPLEMENTED
- **includedeleted** (Boolean, or "only") - Optional - Specify if deleted products and events should be included. The value `only` returns only deleted events. Deleted events otherwise return the HTTP status `409 Conflict`. NOTE: Only supported by the `csv` and `geojson` formats, which include `status`.
- **includesuperseded** (Boolean) - Optional - Specify if superseded products should be included. This also includes all deleted products, and is mutually exclusive to the includedeleted parameter. NOTE: Only works when specifying eventid parameter.
- **limit** (Integer [1,20000]) - Optional - Limit the results to the specified number of events. NOTE: The service limits queries to 20000, and any that exceed this limit will generate a HTTP response code “400 Bad Request”.
- **maxdepth** (Decimal [-100, 1000] km) - Optional - Limit to events with depth less than the specified maximum. Defaults to 1000.
- **maxmagnitude** (Decimal) - Optional - Limit to events with a magnitude smaller than the specified maximum.
- **mindepth** (Decimal [-100, 1000] km) - Optional - Limit to events with depth more than the specified minimum. Defaults to -100.
- **minmagnitude** (Decimal) - Optional - Limit to events with a magnitude larger than the specified minimum.
- **offset** (Integer[1,∞]) - Optional - Return results starting at the event count specified, starting at 1. Defaults to 1.
- **orderby** (String) - Optional - Order the results. The allowed values are: `time` (order by origin descending time), `time-asc` (order by origin ascending time), `magnitude` (order by descending magnitude), `magnitude-asc` (order by ascending magnitude). Defaults to `time`.

### Request Example
```
GET /event?minmagnitude=6.0&orderby=magnitude-desc
```

### Response
#### Success Response (200)
- **(Response structure depends on the format requested, e.g., GeoJSON, CSV, etc.)**

#### Response Example
```json
{
  "type": "FeatureCollection",
  "metadata": {
    "generated": 1678886400000,
    "url": "https://earthquake.usgs.gov/fdsnws/event/1/query?format=geojson&minmagnitude=6.0&orderby=magnitude-desc",
    "title": "USGS GeoJSON Feed",
    "status": 200,
    "api": "1.15.0",
    "count": 1,
    "generatedBy": "USGS",
    "ந்தது": "USGS"
  },
  "features": [
    {
      "type": "Feature",
      "properties": {
        "mag": 6.5,
        "place": "near the coast of Chile",
        "time": 1678872000000,
        "updated": 1678872000000,
        "tz": null,
        "url": "https://earthquake.usgs.gov/earthquakes/eventpage/us7000xxxx-us",
        "detail": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=us7000xxxx-us",
        "felt": null,
        "cdi": null,
        "mmi": null,
        "alert": null,
        "status": "reviewed",
        "tsunami": 0,
        "type": "earthquake",
        "title": "M 6.5 - near the coast of Chile"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -70.0,
          -20.0,
          33.0
        ]
      }
    }
  ]
}
```
```

--------------------------------

### GeoJSON Earthquake Event Structure

Source: https://earthquake.usgs.gov/fdsnws/event/1/query_endtime=2014-01-02&format=geojson&starttime=2014-01-01

This snippet illustrates the basic GeoJSON structure for a single earthquake event as provided by the USGS FDSNWS Event API. It includes properties like magnitude, place, time, and URLs for more details, along with the geographical coordinates.

```json
{
  "type": "Feature",
  "properties": {
    "mag": 1.3,
    "place": "8 km W of Cobb, California",
    "time": 1388612358450,
    "updated": 1486062931100,
    "tz": null,
    "url": "https://earthquake.usgs.gov/earthquakes/eventpage/nc72134386",
    "detail": "https://earthquake.usgs.gov/fdsnws/event/1/query?eventid=nc72134386&format=geojson",
    "felt": null,
    "cdi": null,
    "mmi": null,
    "alert": null,
    "status": "reviewed",
    "tsunami": 0,
    "sig": 26,
    "net": "nc",
    "code": "72134386",
    "ids": ",nc72134386,",
    "sources": ",nc,",
    "types": ",focal-mechanism,nearby-cities,origin,phase-data,scitech-link,",
    "nst": 50,
    "dmin": 0.009009,
    "rms": 0.04,
    "gap": 35,
    "magType": "md",
    "type": "earthquake",
    "title": "M 1.3 - 8 km W of Cobb, California"
  },
  "geometry": {
    "type": "Point",
    "coordinates": [-122.8241667, 38.8173333, 2.61]
  },
  "id": "nc72134386"
}
```

--------------------------------

### Search by Rectangle

Source: https://earthquake.usgs.gov/fdsnws/event/1/index

Retrieve earthquake events within a specified rectangular geographic area. You can define the boundaries using minimum and maximum latitude and longitude.

```APIDOC
## GET /event

### Description
Retrieves earthquake events within a specified rectangular geographic area.

### Method
GET

### Endpoint
/event

### Parameters
#### Query Parameters
- **minlatitude** (Decimal [-90,90] degrees) - Optional - Limit to events with a latitude larger than the specified minimum. Note: min values must be less than max values.
- **minlongitude** (Decimal [-360,360] degrees) - Optional - Limit to events with a longitude larger than the specified minimum. Note: rectangles may cross the date line by using a minlongitude < -180 or maxlongitude > 180. Note: min values must be less than max values.
- **maxlatitude** (Decimal [-90,90] degrees) - Optional - Limit to events with a latitude smaller than the specified maximum. Note: min values must be less than max values.
- **maxlongitude** (Decimal [-360,360] degrees) - Optional - Limit to events with a longitude smaller than the specified maximum. Note: rectangles may cross the date line by using a minlongitude < -180 or maxlongitude > 180. Note: min values must be less than max values.

### Request Example
```
GET /event?minlatitude=30&maxlatitude=40&minlongitude=-120&maxlongitude=-110
```

### Response
#### Success Response (200)
- **events** (Array) - A list of earthquake events matching the criteria.

#### Response Example
```json
{
  "events": [
    {
      "datetime": "2023-01-01T12:00:00.000Z",
      "latitude": 35.0,
      "longitude": -115.0,
      "magnitude": 5.0
    }
  ]
}
```
```

--------------------------------

### Search by Circle

Source: https://earthquake.usgs.gov/fdsnws/event/1/index

Retrieve earthquake events within a specified circular geographic area. You must provide latitude, longitude, and either maxradius or maxradiuskm.

```APIDOC
## GET /event

### Description
Retrieves earthquake events within a specified circular geographic area.

### Method
GET

### Endpoint
/event

### Parameters
#### Query Parameters
- **latitude** (Decimal [-90,90] degrees) - Required - Specify the latitude to be used for a radius search.
- **longitude** (Decimal [-180,180] degrees) - Required - Specify the longitude to be used for a radius search.
- **maxradius** (Decimal [0, 180] degrees) - Required - Limit to events within the specified maximum number of degrees from the geographic point defined by the latitude and longitude parameters. Note: This option is mutually exclusive with maxradiuskm and specifying both will result in an error.
- **maxradiuskm** (Decimal [0, 20001.6] km) - Required - Limit to events within the specified maximum number of kilometers from the geographic point defined by the latitude and longitude parameters. Note: This option is mutually exclusive with maxradius and specifying both will result in an error.

### Request Example
```
GET /event?latitude=35&longitude=-115&maxradiuskm=100
```

### Response
#### Success Response (200)
- **events** (Array) - A list of earthquake events matching the criteria.

#### Response Example
```json
{
  "events": [
    {
      "datetime": "2023-01-01T12:00:00.000Z",
      "latitude": 35.1,
      "longitude": -115.1,
      "magnitude": 4.5
    }
  ]
}
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.