Skip to main content
GET
/
v1
/
monitors
/
{monitor_id}
/
events
List Monitor Events
import requests

url = "https://api.parallel.ai/v1/monitors/{monitor_id}/events"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)
{
  "events": [
    {
      "event_id": "<string>",
      "monitor_group_id": "<string>",
      "event_date": "2026-04-07",
      "output": {
        "basis": [
          {
            "field": "<string>",
            "reasoning": "<string>",
            "citations": [],
            "confidence": "low"
          }
        ],
        "type": "<string>",
        "content": "<string>",
        "mcp_tool_calls": [
          {
            "tool_call_id": "<string>",
            "server_name": "<string>",
            "tool_name": "<string>",
            "arguments": "<string>",
            "content": "<string>",
            "error": "<string>"
          }
        ],
        "beta_fields": {}
      },
      "event_type": "event_stream"
    }
  ],
  "next_cursor": "<string>",
  "warnings": [
    {
      "type": "spec_validation_warning",
      "message": "<string>",
      "detail": {}
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.parallel.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
monitor_id
string
required

Query Parameters

​
event_group_id
string | null

Filter to a single execution. Values come from monitor_group_id in webhook events and listed events. Pagination params are ignored when set.

​
cursor
string | null

Pass next_cursor from a previous response to retrieve more events.

​
limit
integer | null

Maximum number of events to return. Defaults to 20. Between 1 and 100.

Required range: 1 <= x <= 100
​
include_completions
boolean
default:false

When true, include completion events for executions that ran but detected no material changes. Useful for auditing execution history.

Response

Monitor events retrieved successfully.

Paginated list of monitor events, newest first.

​
events
(MonitorEventStreamEvent · object | MonitorSnapshotEvent · object | MonitorCompletionEvent · object | MonitorErrorEvent · object)[]
required

Monitor events returned by this request, ordered newest first.

Append-only event from an event_stream monitor.

Each event represents a distinct material change detected since the previous execution. Events are net-new relative to the cursor; clients should treat them as an append-only log.

​
next_cursor
string | null

Pass as cursor to retrieve more events. Absent when there are no more events.

​
warnings
Warning · object[] | null

Execution caveats for this page of events, e.g. compute limits.