Skip to main content
Fetches earthquake events within a specific Italian administrative region using predefined bounding boxes. This endpoint is ideal for regional monitoring and analysis of Italian seismic zones.

​
Endpoint

Method: GET
Path: /v1/earthquakes/region
Authentication: Not required

​
Parameters

​
region
string
required
Italian region name (case-insensitive).Validation:
  • Must be a non-empty string
  • Must match a supported Italian region (see list below)
  • Returns 400 error if missing: “The ‘region’ parameter is required and must be a valid string. Example: ?region=Calabria”
  • Returns 400 error if unsupported: “Region '' is not supported. Please provide a valid Italian region.”
​
page
integer
default:"1"
Page number for pagination. Must be a positive integer greater than 0.Validation:
  • Must be > 0
  • Returns 400 error if invalid
​
limit
integer
default:"50"
Number of results per page. Must be a positive integer greater than 0.Validation:
  • Must be > 0
  • Returns 400 error if invalid
​
sort
string
default:"-time"
Sort order for results. Prefix with - for descending order.Allowed values:
  • time or -time (default: descending)
  • magnitude or -magnitude
  • depth or -depth
​
fields
string
Comma-separated list of fields to include in response.Allowed values:
  • time
  • magnitude
  • depth
  • place
  • coordinates

​
Supported Italian Regions

The following regions are supported (case-insensitive):
  • Abruzzo
  • Basilicata
  • Calabria
  • Campania
  • Emilia-Romagna
  • Friuli-Venezia Giulia
  • Lazio
  • Liguria
  • Lombardia
  • Marche
  • Molise
  • Piemonte
  • Puglia
  • Sardegna
  • Sicilia
  • Toscana
  • Trentino-Alto Adige
  • Umbria
  • Valle d’Aosta
  • Veneto

​
Request Example

# Earthquakes in Calabria
curl "https://api.terraquakeapi.com/v1/earthquakes/region?region=Calabria"

# Earthquakes in Sicily
curl "https://api.terraquakeapi.com/v1/earthquakes/region?region=Sicilia&limit=100"

# Case-insensitive region name
curl "https://api.terraquakeapi.com/v1/earthquakes/region?region=calabria"

​
Response

​
success
boolean
Indicates if the request was successful
​
code
integer
HTTP status code (200 for success)
​
status
string
HTTP status message (“OK” for success)
​
message
string
Human-readable message. Format: “Earthquake events detected in the region '' from to ”
​
payload
array
Array of GeoJSON Feature objects containing earthquake data
​
meta
object
Request metadata containing method, path, and timestamp
​
totalEarthquakes
integer
Total count of earthquakes in the specified region
​
pagination
object
Pagination details with page, totalPages, limit, and hasMore

​
Response Example

{
  "success": true,
  "code": 200,
  "status": "OK",
  "message": "Earthquake events detected in the region 'Calabria' from 2025-01-01 to 2025-11-06",
  "payload": [
    {
      "type": "Feature",
      "properties": {
        "eventId": 44278572,
        "originId": 140102761,
        "time": "2025-09-26T19:33:46.440000",
        "author": "SURVEY-INGV",
        "magType": "ML",
        "mag": 1,
        "magAuthor": "--",
        "type": "earthquake",
        "place": "Costa Calabra sud-orientale (Reggio di Calabria)",
        "version": 100,
        "geojson_creationTime": "2025-11-06T00:52:30"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [16.2387, 37.9982, 10.5]
      }
    }
  ],
  "meta": {
    "method": "GET",
    "path": "/v1/earthquakes/region?region=Calabria",
    "timestamp": "2025-11-06T01:00:00.000Z"
  },
  "totalEarthquakes": 1456,
  "pagination": {
    "page": 1,
    "totalPages": 30,
    "limit": 50,
    "hasMore": true
  }
}

​
Error Responses

​
Missing Region Parameter

{
  "success": false,
  "code": 400,
  "status": "Bad Request",
  "message": "The 'region' parameter is required and must be a valid string. Example: ?region=Calabria"
}

​
Unsupported Region

{
  "success": false,
  "code": 400,
  "status": "Bad Request",
  "message": "Region 'InvalidRegion' is not supported. Please provide a valid Italian region."
}

​
Invalid Pagination

{
  "success": false,
  "code": 400,
  "status": "Bad Request",
  "message": "The 'limit' parameter must be a positive integer greater than 0. Example: ?limit=50"
}

​
Implementation Details

  • Region Matching: Region names are normalized to lowercase and trimmed before matching
  • Bounding Boxes: Each region has predefined bounding box coordinates (minlatitude, maxlatitude, minlongitude, maxlongitude)
  • Bounding Box Source: Loaded from regionBoundingBoxes configuration
  • Date Range: From start of current year to today
  • INGV Query: Uses geographic bounds: minlatitude, maxlatitude, minlongitude, maxlongitude
  • Sorting: Default sort is by time (most recent first: -time)
  • Pagination: Manual pagination applied after fetching all events from INGV

​
Use Cases

  • Regional seismic activity monitoring
  • Italian civil protection and emergency services
  • Regional risk assessment and planning
  • Comparative analysis between regions
  • Local government reporting

​
Regional Seismic Activity

Some of the most seismically active Italian regions:
  • Calabria - High seismic activity due to tectonic plate boundaries
  • Sicilia - Active due to Mt. Etna and tectonic activity
  • Abruzzo - Known for significant historical earthquakes
  • Marche - Central Apennines seismic zone
  • Friuli-Venezia Giulia - Alpine seismic zone

Build docs developers (and LLMs) love

Get started for freeTalk to us