Merge API

Merge Catalogues

Merge multiple catalogues into a new catalogue.

Endpoint: POST /api/merge

Request Body:

{
  "name": "Merged Catalogue",
  "sourceCatalogues": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "GeoNet 2024",
      "events": 15432,
      "source": "geonet"
    },
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "name": "USGS Southwest Pacific",
      "events": 3241,
      "source": "usgs"
    }
  ],
  "config": {
    "timeThreshold": 60,
    "distanceThreshold": 50,
    "mergeStrategy": "quality",
    "priority": ""
  }
}

Merge Strategy Options (config.mergeStrategy):

• "quality": Select the event with the highest quality score (station count, azimuthal gap, RMS, magnitude uncertainty, magnitude type, review status). Recommended for scientific use.

• "priority": Always keep the event from the source matching config.priority.

• "average": Weighted-average location, magnitude hierarchy selection, lowest-uncertainty depth.

• "newest": Keep the event with the latest origin time.

• "complete": Keep the event with the most populated fields.

Response: 200 OK

{
  "success": true,
  "catalogueId": "770e8400-e29b-41d4-a716-446655440002",
  "eventCount": 2500,
  "originalEventCount": 27429
}

Note

eventCount is the number of unique events in the merged catalogue. originalEventCount is the total events across all source catalogues before deduplication.