list_events¶

Science¶

list_events lists catalogue rows in a time window (at most 31 days) and an optional geographic area, optionally filtered by a minimum network magnitude. Results are newest-first. The session fence is applied; the payload says so.

A catalogue of automatic detections is not a complete bulletin. More than one automatic solution may exist for one physical event, and events that no pipeline detected are absent. truncated is a page-size fact, not a completeness statement.

Event-bound reviewer profiles hide this tool: a session that is already tied to one subject has no reason to browse.

Contract¶

Generated from the live registry (ToolSpec). Field names, types and defaults come from the input and payload models; they are not hand-typed.


Group	`catalog`
Class	1
Tool version	`1.0.0`
Highest declared tier	F
Timeout	5 s
Budget key	`none`
`readOnlyHint`	true
`idempotentHint`	true

Input¶

Field	Type	Required	Notes
`t_from_utc`	string	yes
`t_to_utc`	string	yes
`area`	object (kind `bbox` \| `circle`) \| null	no	default `null`
`min_magnitude_ml`	number \| null	no	default `null`
`limit`	integer	no	default `100`; ≥ `1`

Payload¶

Field	Type	Required
`events`	array[object]	yes
`events[]`	object	no
`truncated`	boolean	yes
`fence_applied`	boolean	yes

Example request¶

{
  "t_from_utc": "2024-06-01T00:00:00.000Z",
  "t_to_utc": "2024-06-15T23:59:59.000Z",
  "area": {
    "kind": "circle",
    "latitude_deg": 47.15,
    "longitude_deg": 24.5,
    "radius_km": 50
  },
  "min_magnitude_ml": 1.5,
  "limit": 100
}

Example payload¶

{
  "events": [
    {
      "event_id": 1001,
      "origin_time_utc": "2024-06-15T08:12:03.417Z",
      "latitude_deg": 47.15,
      "longitude_deg": 24.5,
      "depth_km": 10.0,
      "magnitude_ml": 2.1,
      "num_phases": 9,
      "local_time": {
        "tz": "configured_iana_tz",
        "hour": 11,
        "minute": 12,
        "weekday": "sat"
      }
    }
  ],
  "truncated": false,
  "fence_applied": true
}

What this tool does not tell you¶

What this tool does not tell you: completeness. The catalogue can hold more than one row per physical event (parallel detection pipelines) and is missing whatever no pipeline detected.