> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # List Monitor Events > List events for a monitor, newest first. Pass event_group_id to narrow results to a single execution. Use next_cursor for pagination. Set include_completions=true to include no-change executions. ## OpenAPI ````yaml openapi/parallel.ai.json GET /apis/v1/parallel/monitors/{monitor_id}/events openapi: 3.1.0 info: description: '' title: Parallel.ai version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/parallel/chat/completions - /apis/v1/parallel/extract - /apis/v1/parallel/findall/ingest - /apis/v1/parallel/findall/runs/{findall_id} - /apis/v1/parallel/findall/runs/{findall_id}/cancel - /apis/v1/parallel/findall/runs/{findall_id}/events - /apis/v1/parallel/findall/runs/{findall_id}/result - /apis/v1/parallel/findall/runs/{findall_id}/schema - /apis/v1/parallel/monitors/{monitor_id} - /apis/v1/parallel/monitors/{monitor_id}/cancel - /apis/v1/parallel/monitors/{monitor_id}/events - /apis/v1/parallel/monitors/{monitor_id}/update - /apis/v1/parallel/tasks/groups - /apis/v1/parallel/tasks/groups/{taskgroup_id} - /apis/v1/parallel/tasks/groups/{taskgroup_id}/events - /apis/v1/parallel/tasks/groups/{taskgroup_id}/runs/{run_id} - /apis/v1/parallel/tasks/runs/{run_id} - /apis/v1/parallel/tasks/runs/{run_id}/events - /apis/v1/parallel/tasks/runs/{run_id}/input - /apis/v1/parallel/tasks/runs/{run_id}/result - /apis/v1/parallel/v1beta/tasks/runs/{run_id}/events x-aisa-document: facts_hash: 7d3bf2025708131927d3136de215ba314114253046b35f239876910b2481cbd9 generator_version: '2' protocol_version: '1' schema_version: '1' composer_version: '13' response_pending: [] document_hash: sha256:dae9e982424f710c06d9af023168dd26ed96bf5e5b5232e0728c01867d2da7dc x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: parallel.ai x-aisa-catalogs: parallel.ai: title: Parallel.ai description: '' x-aisa-document: facts_hash: 7d3bf2025708131927d3136de215ba314114253046b35f239876910b2481cbd9 generator_version: '2' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/parallel/monitors/{monitor_id}/events: get: tags: - default summary: List Monitor Events description: >- List events for a monitor, newest first. Pass event_group_id to narrow results to a single execution. Use next_cursor for pagination. Set include_completions=true to include no-change executions. operationId: any_parallel_ai_apis_v1_parallel_monitors_monitor_c3a273 parameters: - name: monitor_id in: path required: true schema: type: string title: Monitor Id - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Pass `next_cursor` from a previous response to retrieve more events. title: Cursor description: Pass `next_cursor` from a previous response to retrieve more events. - name: event_group_id in: query required: false schema: anyOf: - type: string - type: 'null' description: >- Filter to a single execution. Values come from `event_group_id` in webhook events and listed events. Pagination params are ignored when set. title: Event Group Id description: >- Filter to a single execution. Values come from `event_group_id` in webhook events and listed events. Pagination params are ignored when set. - name: include_completions in: query required: false schema: type: boolean description: >- When true, include completion events for executions that ran but detected no material changes. Useful for auditing execution history. default: false title: Include Completions description: >- When true, include completion events for executions that ran but detected no material changes. Useful for auditing execution history. - name: limit in: query required: false schema: anyOf: - type: integer maximum: 100 minimum: 1 - type: 'null' description: >- Maximum number of events to return. Defaults to 20. Between 1 and 100. title: Limit description: >- Maximum number of events to return. Defaults to 20. Between 1 and 100. responses: '200': description: Monitor events retrieved successfully. content: application/json: schema: $ref: >- #/components/schemas/ResponseB67C75A8Feba_PaginatedMonitorEvents default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseB67C75A8Feba_PaginatedMonitorEvents: properties: events: items: oneOf: - $ref: >- #/components/schemas/ResponseB67C75A8Feba_MonitorEventStreamEvent - $ref: '#/components/schemas/ResponseB67C75A8Feba_MonitorSnapshotEvent' - $ref: >- #/components/schemas/ResponseB67C75A8Feba_MonitorCompletionEvent - $ref: '#/components/schemas/ResponseB67C75A8Feba_MonitorErrorEvent' discriminator: propertyName: event_type mapping: completion: >- #/components/schemas/ResponseB67C75A8Feba_MonitorCompletionEvent error: '#/components/schemas/ResponseB67C75A8Feba_MonitorErrorEvent' event_stream: >- #/components/schemas/ResponseB67C75A8Feba_MonitorEventStreamEvent snapshot: '#/components/schemas/ResponseB67C75A8Feba_MonitorSnapshotEvent' type: array title: Events description: Monitor events returned by this request, ordered newest first. next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor description: >- Pass as `cursor` to retrieve more events. Absent when there are no more events. warnings: anyOf: - items: $ref: '#/components/schemas/ResponseB67C75A8Feba_Warning' type: array - type: 'null' title: Warnings description: Execution caveats for this page of events, e.g. compute limits. type: object required: - events title: PaginatedMonitorEvents description: Paginated list of monitor events, newest first. ResponseB67C75A8Feba_MonitorEventStreamEvent: properties: event_id: type: string title: Event Id description: >- Stable identifier for this event. Safe to use for client-side deduplication across pagination and retries. event_group_id: type: string title: Event Group Id description: ID of the event group that owns this event. event_date: anyOf: - type: string - type: 'null' title: Event Date description: >- Date when this event was produced. ISO 8601 date (YYYY-MM-DD) or partial (YYYY-MM or YYYY). examples: - '2026-04-07' event_type: type: string enum: - event_stream const: event_stream title: Event Type description: Discriminant for the event_stream event variant. default: event_stream output: oneOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunTextOutput' - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunJsonOutput' title: Output description: Text or JSON output describing the detected change. discriminator: propertyName: type mapping: json: '#/components/schemas/ResponseB67C75A8Feba_TaskRunJsonOutput' text: '#/components/schemas/ResponseB67C75A8Feba_TaskRunTextOutput' type: object required: - event_id - event_group_id - event_date - output title: MonitorEventStreamEvent description: |- 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. ResponseB67C75A8Feba_MonitorSnapshotEvent: properties: event_id: type: string title: Event Id description: >- Stable identifier for this event. Safe to use for client-side deduplication across pagination and retries. event_group_id: type: string title: Event Group Id description: ID of the event group that owns this event. event_date: anyOf: - type: string - type: 'null' title: Event Date description: >- Date when this event was produced. ISO 8601 date (YYYY-MM-DD) or partial (YYYY-MM or YYYY). examples: - '2026-04-07' event_type: type: string enum: - snapshot const: snapshot title: Event Type description: Discriminant for the snapshot event variant. default: snapshot changed_output: oneOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunTextOutput' - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunJsonOutput' title: Changed Output description: >- Partial output containing only the fields that changed since the previous execution, each with its `basis` (reasoning and citations). discriminator: propertyName: type mapping: json: '#/components/schemas/ResponseB67C75A8Feba_TaskRunJsonOutput' text: '#/components/schemas/ResponseB67C75A8Feba_TaskRunTextOutput' previous_output: oneOf: - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunTextOutput' - $ref: '#/components/schemas/ResponseB67C75A8Feba_TaskRunJsonOutput' title: Previous Output description: The full output from the prior run, including all fields and basis. discriminator: propertyName: type mapping: json: '#/components/schemas/ResponseB67C75A8Feba_TaskRunJsonOutput' text: '#/components/schemas/ResponseB67C75A8Feba_TaskRunTextOutput' type: object required: - event_id - event_group_id - event_date - changed_output - previous_output title: MonitorSnapshotEvent description: >- Snapshot diff event emitted when a monitored task run's output changes. `changed_output` contains only the fields that changed since the previous execution, along with their `basis` (reasoning + citations). `previous_output` holds the complete output from the prior run for comparison. ResponseB67C75A8Feba_MonitorCompletionEvent: properties: event_type: type: string enum: - completion const: completion title: Event Type description: Discriminant for the completion event variant. default: completion timestamp: type: string format: date-time title: Timestamp description: >- Timestamp of when the monitor execution completed, as an RFC 3339 string. examples: - '2025-01-15T10:30:00Z' type: object required: - timestamp title: MonitorCompletionEvent description: >- Emitted when a monitor execution ran but detected no material changes. Only returned when `include_completions=true` is passed to the list events endpoint. Useful for auditing execution history alongside content events. ResponseB67C75A8Feba_MonitorErrorEvent: properties: event_type: type: string enum: - error const: error title: Event Type description: Discriminant for the error event variant. default: error error_message: type: string title: Error Message description: Human-readable description of the failure. timestamp: type: string format: date-time title: Timestamp description: >- Timestamp of when the monitor execution failed, as an RFC 3339 string. examples: - '2025-01-15T10:30:00Z' type: object required: - error_message - timestamp title: MonitorErrorEvent description: |- Emitted when a monitor execution failed (e.g. payment or quota error). Always included in the events list regardless of `include_completions`. ResponseB67C75A8Feba_Warning: properties: type: type: string enum: - spec_validation_warning - input_validation_warning - warning title: Type description: >- Type of warning. Note that adding new warning types is considered a backward-compatible change. examples: - spec_validation_warning - input_validation_warning message: type: string title: Message description: Human-readable message. detail: anyOf: - additionalProperties: true type: object - type: 'null' title: Detail description: Optional detail supporting the warning. type: object required: - type - message title: Warning description: Human-readable message for a task. ResponseB67C75A8Feba_TaskRunTextOutput: properties: basis: items: $ref: '#/components/schemas/ResponseB67C75A8Feba_FieldBasis' type: array title: Basis description: Basis for the output. The basis has a single field 'output'. type: type: string const: text title: Type description: >- The type of output being returned, as determined by the output schema of the task spec. mcp_tool_calls: anyOf: - items: $ref: '#/components/schemas/ResponseB67C75A8Feba_McpToolCall' type: array - type: 'null' title: Mcp Tool Calls description: MCP tool calls made by the task. beta_fields: anyOf: - additionalProperties: true type: object - type: 'null' title: Beta Fields description: >- Deprecated. mcp-server-2025-07-17 is now included directly in the output (e.g. mcp_tool_calls). deprecated: true content: type: string title: Content description: Text output from the task. type: object required: - basis - type - content title: TaskRunTextOutput description: Output from a task that returns text. ResponseB67C75A8Feba_TaskRunJsonOutput: properties: basis: items: $ref: '#/components/schemas/ResponseB67C75A8Feba_FieldBasis' type: array title: Basis description: >- Basis for each top-level field in the JSON output. List fields also include per-element entries with dot-delimited indexes, such as `key_executives.0`. type: type: string const: json title: Type description: >- The type of output being returned, as determined by the output schema of the task spec. mcp_tool_calls: anyOf: - items: $ref: '#/components/schemas/ResponseB67C75A8Feba_McpToolCall' type: array - type: 'null' title: Mcp Tool Calls description: MCP tool calls made by the task. beta_fields: anyOf: - additionalProperties: true type: object - type: 'null' title: Beta Fields description: >- Deprecated. mcp-server-2025-07-17 is now included directly in the output (e.g. mcp_tool_calls). deprecated: true content: additionalProperties: true type: object title: Content description: >- Output from the task as a native JSON object, as determined by the output schema of the task spec. output_schema: anyOf: - additionalProperties: true type: object - type: 'null' title: Output Schema description: >- Output schema for the Task Run. Populated only if the task was executed with an auto schema. type: object required: - basis - type - content title: TaskRunJsonOutput description: Output from a task that returns JSON. ResponseB67C75A8Feba_FieldBasis: description: Citations and reasoning supporting one field of a task output. properties: field: description: Name of the output field. title: Field type: string citations: default: [] description: List of citations supporting the output field. items: $ref: '#/components/schemas/ResponseB67C75A8Feba_Citation' title: Citations type: array reasoning: description: Reasoning for the output field. title: Reasoning type: string confidence: anyOf: - type: string - type: 'null' default: null description: >- Confidence level for the output field. Only certain processors provide confidence levels. examples: - low - medium - high title: Confidence required: - field - reasoning title: FieldBasis type: object ResponseB67C75A8Feba_McpToolCall: properties: tool_call_id: type: string title: Tool Call ID description: Identifier for the tool call. server_name: type: string title: Server Name description: Name of the MCP server. tool_name: type: string title: Tool Name description: Name of the tool being called. arguments: type: string title: Arguments description: Arguments used to call the MCP tool. content: anyOf: - type: string - type: 'null' title: Content description: Output received from the tool call, if successful. error: anyOf: - type: string - type: 'null' title: Error description: Error message if the tool call failed. type: object required: - tool_call_id - server_name - tool_name - arguments title: McpToolCall description: Result of an MCP tool call. ResponseB67C75A8Feba_Citation: description: A citation for a task output. properties: title: anyOf: - type: string - type: 'null' default: null description: Title of the citation. title: Title url: description: URL of the citation. title: Url type: string excerpts: anyOf: - items: type: string type: array - type: 'null' default: null description: >- Excerpts from the citation supporting the output. Only certain processors provide excerpts. title: Excerpts required: - url title: Citation type: object securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.