GET v1/stations/geojson - TerraQuake API

Endpoint

GET https://api.terraquakeapi.com/v1/stations/geojson

Description

Returns the complete list of INGV seismic monitoring stations formatted as GeoJSON FeatureCollection. This endpoint is optimized for mapping applications, GIS integration, and spatial visualization libraries like Mapbox, Leaflet, and Google Maps. Each station is represented as a GeoJSON Point Feature with 3D coordinates (longitude, latitude, elevation) and essential metadata in the properties object.

Use Cases

Interactive Maps: Display stations on web maps (Mapbox, Leaflet, Google Maps)
GIS Analysis: Import into QGIS, ArcGIS, or other GIS software
Spatial Queries: Perform geometric operations and spatial filtering
Data Visualization: Create heatmaps, cluster maps, and coverage visualizations
Mobile Apps: Integrate with mobile mapping SDKs

Parameters

integer

default:"50"

Number of station features to return per page. Must be a positive integer greater than 0. Maximum: 1000 Example: ?limit=100

integer

default:"1"

Page number for pagination. Must be a positive integer greater than 0. Example: ?page=2

Request Examples

curl "https://api.terraquakeapi.com/v1/stations/geojson?limit=100&page=1"

// Load stations into Mapbox
const response = await fetch(
  'https://api.terraquakeapi.com/v1/stations/geojson?limit=500',
);
const data = await response.json();

// Create GeoJSON FeatureCollection from paginated results
const geojson = {
  type: 'FeatureCollection',
  features: data.payload,
};

// Add source to map
map.addSource('seismic-stations', {
  type: 'geojson',
  data: geojson,
});

// Add circle layer
map.addLayer({
  id: 'stations-circle',
  type: 'circle',
  source: 'seismic-stations',
  paint: {
    'circle-radius': 6,
    'circle-color': [
      'match',
      ['get', 'status'],
      'open',
      '#10b981',
      'closed',
      '#ef4444',
      '#6b7280',
    ],
    'circle-stroke-width': 2,
    'circle-stroke-color': '#ffffff',
  },
});

// Add labels
map.addLayer({
  id: 'stations-label',
  type: 'symbol',
  source: 'seismic-stations',
  layout: {
    'text-field': ['get', 'code'],
    'text-size': 12,
    'text-offset': [0, 1.5],
  },
});

// Load stations into Leaflet
const response = await fetch(
  'https://api.terraquakeapi.com/v1/stations/geojson?limit=500',
);
const data = await response.json();

// Create GeoJSON layer
const stationsLayer = L.geoJSON(data.payload, {
  pointToLayer: function (feature, latlng) {
    const isOpen = feature.properties.status === 'open';
    return L.circleMarker(latlng, {
      radius: 6,
      fillColor: isOpen ? '#10b981' : '#ef4444',
      color: '#fff',
      weight: 2,
      opacity: 1,
      fillOpacity: 0.8,
    });
  },
  onEachFeature: function (feature, layer) {
    const props = feature.properties;
    layer.bindPopup(`
      <strong>${props.code}</strong><br>
      ${props.site}<br>
      Status: ${props.status}<br>
      Elevation: ${feature.geometry.coordinates[2]}m
    `);
  },
}).addTo(map);

import requests
import geopandas as gpd
from shapely.geometry import Point

# Fetch GeoJSON data
url = "https://api.terraquakeapi.com/v1/stations/geojson?limit=500"
response = requests.get(url)
data = response.json()

if data.get('success'):
    # Convert to GeoDataFrame
    features = data['payload']
    gdf = gpd.GeoDataFrame.from_features(features)

    # Now you can perform spatial operations
    print(f"Total stations: {len(gdf)}")
    print(f"\nStations by status:")
    print(gdf['status'].value_counts())

    # Filter open stations
    open_stations = gdf[gdf['status'] == 'open']
    print(f"\nOpen stations: {len(open_stations)}")

    # Save to GeoJSON file
    gdf.to_file("ingv_stations.geojson", driver="GeoJSON")

Response Format

boolean

Indicates if the request was successful

integer

HTTP status code (200 for success)

string

HTTP status message

string

Human-readable description (“Stations format geojson”)

array

Array of GeoJSON Feature objects (see GeoJSON Feature structure below)

integer

Total number of station features available

object

Pagination metadata

integer

Current page number

integer

Total number of pages

integer

Features per page

boolean

Whether more pages are available

object

Request metadata (method, path, timestamp)

GeoJSON Feature Structure

Each feature in the payload array follows the GeoJSON specification:

string

Always “Feature” for GeoJSON features

object

GeoJSON Point geometry

string

Always “Point”

array

3D coordinate array: [longitude, latitude, elevation] - [0] (longitude): East-west position in decimal degrees (-180 to 180) - [1] (latitude): North-south position in decimal degrees (-90 to 90) - [2] (elevation): Height above sea level in meters

object

Station metadata

string

Unique station code (e.g., “ACATE”)

string

Full station name including network prefix

string

Human-readable site location name

string

Operational status: “open”, “closed”, “inactive”, “deprecated”, “unavailable”, or “unknow” (sic)

Response Example

{
  "success": true,
  "code": 200,
  "status": "OK",
  "message": "Stations format geojson",
  "payload": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [14.4983, 37.0287, 206.0]
      },
      "properties": {
        "code": "ACATE",
        "name": "IV.ACATE",
        "site": "Acate (RG)",
        "status": "open"
      }
    },
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [15.9428, 40.7328, 652.0]
      },
      "properties": {
        "code": "ACER",
        "name": "IV.ACER",
        "site": "Acerenza (PZ)",
        "status": "open"
      }
    }
  ],
  "meta": {
    "method": "GET",
    "path": "/v1/stations/geojson?limit=2&page=1",
    "timestamp": "2025-11-06T11:15:30.420Z"
  },
  "totalStations": 450,
  "pagination": {
    "page": 1,
    "totalPages": 225,
    "limit": 2,
    "hasMore": true
  }
}

Error Responses

Invalid Limit Parameter

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

Invalid Page Parameter

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

Complete FeatureCollection Example

To use with most mapping libraries, wrap the payload in a FeatureCollection:

const response = await fetch(
  'https://api.terraquakeapi.com/v1/stations/geojson?limit=500',
);
const data = await response.json();

// Create standard GeoJSON FeatureCollection
const featureCollection = {
  type: 'FeatureCollection',
  features: data.payload,
};

// Now compatible with any GeoJSON library
map.addSource('stations', {
  type: 'geojson',
  data: featureCollection,
});

Filtering by Status

Filter stations by operational status after fetching:

const response = await fetch(
  'https://api.terraquakeapi.com/v1/stations/geojson?limit=500',
);
const data = await response.json();

// Filter for open stations only
const openStations = {
  type: 'FeatureCollection',
  features: data.payload.filter((f) => f.properties.status === 'open'),
};

console.log(`Open stations: ${openStations.features.length}`);

Coordinate Reference System

All coordinates use the WGS84 datum (EPSG:4326):

Longitude/Latitude in decimal degrees
Elevation in meters above mean sea level

This is the standard coordinate system for web mapping and GPS.

Get All Stations

Get full station details (non-GeoJSON)

Active Stations

Filter for operational stations

Closed Stations

Get inactive station locations

Statistics

View network metrics

​Endpoint

​Description

​Use Cases

​Parameters

​Request Examples

​Response Format

​GeoJSON Feature Structure

​Response Example

​Error Responses

​Invalid Limit Parameter

​Invalid Page Parameter

​Complete FeatureCollection Example

​Filtering by Status

​Coordinate Reference System

​Related Endpoints

Get All Stations

Active Stations

Closed Stations

Statistics

Endpoint

Description

Use Cases

Parameters

Request Examples

Response Format

GeoJSON Feature Structure

Response Example

Error Responses

Invalid Limit Parameter

Invalid Page Parameter

Complete FeatureCollection Example

Filtering by Status

Coordinate Reference System

Related Endpoints