---
title: "queryInboundMonitoringEvents"
method: POST
path: "/v1/integrations/{integrationId}/monitoring/inbound-events"
tags: ["monitoring", "integrations"]
---

# queryInboundMonitoringEvents

`POST /v1/integrations/{integrationId}/monitoring/inbound-events`

Query inbound monitoring events for a specific integration.
Returns detailed information about inbound sync events from ERP systems,
including success rates, error breakdowns, and processing metrics.

## Path parameters

- `integrationId` string, uuid, required

## Request body

- QueryInboundMonitoringEventsRequest
  - `use_case_id` string, uuid — Filter by use case ID
  - `event_type` 'CREATE' | 'UPDATE' | 'DELETE' | 'TRIGGER' — Filter by event type
  - `sync_type` 'entity' | 'meter_reading' | 'webhook' | 'api_deprecation' — Filter by sync type
  - `status` 'success' | 'error' | 'skipped' | 'warning' — Filter by processing status
  - `error_category` 'validation' | 'configuration' | 'downstream_api' | 'timeout' | 'system' — Filter by error category (only applicable when status=error)
  - `correlation_id` string — Filter by correlation ID
  - `object_type` string — Filter by object type (e.g., 'contract', 'meter')
  - `event_name` string — Filter by event name (alias for object_type)
  - `event_id` string — Filter by event ID to find a specific event
  - `from_date` string, date-time — Filter events from this date (inclusive)
  - `to_date` string, date-time — Filter events until this date (inclusive)
  - `limit` integer — Maximum number of results to return
  - `cursor` object — Cursor for pagination
    - `completed_at` string, date-time — Timestamp from the last event in the previous page
    - `event_id` string — Event ID from the last event in the previous page

## Response `200`

Inbound monitoring events queried successfully

- object
  - `data` InboundMonitoringEvent[] — List of inbound monitoring events
    - `org_id` string, required — Organization ID
    - `event_id` string, required — Unique event identifier
    - `correlation_id` string, nullable — Correlation ID for tracing related events
    - `integration_id` string, nullable — Integration ID
    - `use_case_id` string, nullable — Use case ID
    - `event_type` 'CREATE' | 'UPDATE' | 'DELETE' | 'TRIGGER' — Type of event (optional for V3 events)
    - `object_type` string, required — Type of object being synced (e.g., 'contract', 'meter')
    - `sync_type` 'entity' | 'meter_reading' | 'webhook' | 'api_deprecation', required — Type of sync operation
    - `status` 'success' | 'error' | 'skipped' | 'warning', required — Processing status
    - `error_code` string, nullable — Error code (when status=error)
    - `error_message` string, nullable — Error message (when status=error)
    - `error_category` 'validation' | 'configuration' | 'downstream_api' | 'timeout' | 'system', nullable — Error category (when status=error)
    - `processing_duration_ms` integer, nullable — Processing duration in milliseconds
    - `received_at` string, date-time, required — When the event was received
    - `completed_at` string, date-time, required — When processing completed
  - `next_cursor` object, nullable — Cursor to fetch the next page. Null if no more results.
    - `completed_at` string, date-time
    - `event_id` string
  - `has_more` boolean — Indicates if more results are available

## Other responses

- `400` — Bad request
- `401` — Unauthorized request
- `404` — Resource not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/epilot/apis/integration-toolkit-api.md) · [All operations](https://skmtc.net/epilot/apis/integration-toolkit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/integration-toolkit-api/revisions/c24837d75096/schema)