---
title: "List Global Significant Earthquakes records"
method: GET
path: "/v1/data/global-significant-earthquakes"
tags: ["Geoscience & Environment"]
---

# List Global Significant Earthquakes records

`GET /v1/data/global-significant-earthquakes`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/global-significant-earthquakes`
- Auth: none declared. Required headers: `X-API-Key`

List Global Significant Earthquakes records with optional filters and pagination.

**Source:** U.S. Geological Survey (Public Domain).

**Fields returned:**
- `event_id` (str) — The unique identifier for the earthquake event.
- `event_time_utc` (str) — The time the event occurred in ISO 8601 format (UTC).
- `latitude` (float) — The latitude of the earthquake's epicenter.
- `longitude` (float) — The longitude of the earthquake's epicenter.
- `depth_km` (float) — The depth of the event in kilometers.
- `magnitude` (float) — The magnitude of the earthquake.
- `magnitude_type` (str) — The method or scale used to calculate magnitude (e.g., 'mw', 'ml').
- `place_description` (str) — A human-readable description of the event's location.
- `tsunami_alert` (int) — Indicates if a tsunami alert was issued (1 for yes, 0 for no).
- `status` (str) — The review status of the event, e.g., 'automatic' or 'reviewed'.

**Example:** `GET /v1/data/global-significant-earthquakes?limit=10&magnitude_type=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `magnitude_type` string, nullable: The method or scale used to calculate magnitude (e.g., 'mw', 'ml').
- `tsunami_alert` string, nullable: Indicates if a tsunami alert was issued (1 for yes, 0 for no).
- `status` string, nullable: The review status of the event, e.g., 'automatic' or 'reviewed'.

## Headers

- `X-API-Key` string, required

## Response `200`

A page of Global Significant Earthquakes records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)