Skip to main content
GET
/
api
/
seismology
/
v1
/
list-earthquakes
ListEarthquakes
curl --request GET \
  --url https://api.example.com/api/seismology/v1/list-earthquakes
{
  "earthquakes": [
    {
      "id": "<string>",
      "place": "<string>",
      "magnitude": 123,
      "depthKm": 123,
      "location": {
        "latitude": 0,
        "longitude": 0
      },
      "occurredAt": 123,
      "sourceUrl": "<string>"
    }
  ],
  "pagination": {
    "nextCursor": "<string>",
    "totalCount": 123
  }
}

Query Parameters

start
string<int64>

Start of time range (inclusive), Unix epoch milliseconds.

end
string<int64>

End of time range (inclusive), Unix epoch milliseconds.

page_size
integer<int32>

Maximum items per page (1-100).

cursor
string

Cursor for next page.

min_magnitude
number<double>

Minimum magnitude filter (e.g., 4.0 for significant quakes).

Response

Successful response

ListEarthquakesResponse contains the list of earthquakes matching the request filters.

earthquakes
object[]
pagination
object

PaginationResponse contains pagination metadata returned alongside list results.