--- title: "Get monitoring statuses for a mixed list of projects" method: POST path: "/v1/integration/projects/monitoring/status" tags: ["Monitor Unified Integration Projects"] --- # Get monitoring statuses for a mixed list of projects `POST /v1/integration/projects/monitoring/status` ## Request - Base URL: `https://integration-adapter.connect.cloud.precisely.com` - URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/projects/monitoring/status` - Auth: HTTP bearer Retrieves runtime monitoring statuses for a mixed list of Continuous, Mainframe, and Advanced Replication projects in a single call, delegating to the Connect Monitoring Service's unified bulk status endpoint. Results preserve request order. **Features:** - Accepts 1 to 50 projects per request; `projectId` values must be unique. - Each project's `latency` flag is honored only for Mainframe projects and ignored for Continuous and Advanced projects. - Returns `found: false` and a null `status` for any project with no monitoring data, rather than failing the whole request. **Use Cases:** - Populate a multi-project monitoring dashboard with a single call. - Refresh status for a known set of projects without one call per project. **Authorization:** Requires `replication-pipeline::view`. ## Request body - UnifiedProjectMonitoringStatusRequest[]: 1 to 50 projects; projectId values must be unique - `projectId` string, required: Unique identifier of the project - `projectType` 'REPLICATION' | 'MAINFRAME_REPLICATION' | 'ADVANCED_REPLICATION', required: Project type: REPLICATION | MAINFRAME_REPLICATION | ADVANCED_REPLICATION - `latency` boolean: Mainframe Replication only; ignored for Continuous and Advanced projects ## Response `200` Successfully retrieved project monitoring statuses - UnifiedProjectMonitoringStatusListResponse: Unified monitoring status results for a mixed list of projects - `results` Result[]: One result per requested project, in request order - `id` string: Unique identifier of the underlying monitoring status document - `projectId` string: Unique identifier of the project - `projectType` 'REPLICATION' | 'MAINFRAME_REPLICATION' | 'ADVANCED_REPLICATION': Project type: REPLICATION | MAINFRAME_REPLICATION | ADVANCED_REPLICATION - `tenantId` string: Workspace or tenant identifier - `found` boolean: False when no monitoring data exists for this project - `status` Status: Discriminated monitoring status; only one of the two fields is populated - `continuousAdvanced` ContinuousAdvanced: Monitoring status fields specific to Continuous and Advanced Replication projects - `agentId` string: Unique identifier of the agent - `name` string: Name of the project - `currentEmailRuntimeServer` string: Runtime server used for email notifications - `changes` 'UP_TO_DATE' | 'UPDATE_NEEDED': Indicates if the project is up to date or needs update - `generationTimestamp` string: Timestamp when the status was generated (RFC 3339 UTC) - `dataFlows` MonitoringDataFlowStatus[]: Data flow statuses for the project - `backlogRows` MonitoringBacklogRowStatus - `pendingRows` integer - `pendingTransactions` integer - `timestamp` string - `captureStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `copyPhase` boolean - `dataFlowType` string - `logReaderStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `monitoringRequestProcessing` boolean - `name` string - `overallStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `replicationStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `runtimeServerStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `runtimeServers` MonitoringRuntimeServerStatus[] - `dataConnections` MonitoringDataConnectionStatus[] - … - `hasChange` boolean - `logReaderStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `name` string - `replicationStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `state` string - `status` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `startedAt` string - `stats` MonitoringStats - `apply` MonitoringStatsInfos - … - `averageLatency` MonitoringContinuousAverageLatency - … - `backlogLatency` integer - `captureLatency` integer - `replicationLatency` integer - `retrieve` MonitoringStatsInfos - … - `send` MonitoringStatsInfos - … - `statisticEstimationWindow` string - `totalLatency` integer - `tableMappings` MonitoringTableMappingStatus[] - `mappingDetails` MonitoringTableMappingDetails[] - … - `source` MonitoringTableMappingsStatusDataConnection - … - `target` MonitoringTableMappingsStatusDataConnection - … - `versions` MonitoringProjectVersions[]: Version information for the project - `committedVersion` integer - `deployedVersion` integer - `serverName` string - `cdwhStatsAndStatusInfos` MonitoringMonitoringCDWHStatsAndStatus[]: CDWH stats and status information - `idInfo` MonitoringMonitoringCDWHPipelineIdInfo - `projectName` string - `target` string - `targetType` string - `userPPName` string - `pipelinePhase` string - `stats` MonitoringMonitoringCDWHStatsInfo - `appliedRecordCount` integer - `appliedTransactionCount` integer - `applyLatency` integer - `processedRecordCount` integer - `processedTransactionCount` integer - `readRecordCount` integer - `skipRecordCount` integer - `stagedRecordCount` integer - `stagedTransactionCount` integer - `startedAt` string - `status` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `stopReason` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `virtualId` string: Virtual identifier for the project - `overallPipelineStatuses` MonitoringOverallPipelineStatus[]: Overall pipeline statuses - `copyPhase` boolean - `pipelineName` string - `pipelineStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `replicationStatus` '' | 'STOPPED' | 'OK' | 'ACTION_REQUIRED' | 'UPDATING' | 'IN_PROGRESS' | 'PARTIAL' | 'COMPLETED' | 'NONE' | 'UNKNOWN' | 'RUNNING' | 'STOPPING' | 'COPY_PHASE' | 'STOP_REASON_BY_USER' | 'STOP_REASON_NOT_APPLICABLE' | 'STOP_REASON_ON_COPYREQUEST_COMPLETE' | 'STOP_REASON_ON_ERROR' | 'IGNORED' | 'DISABLED' | 'STARTING' | 'INFORMATION' | 'ATTENTION' - `mainframe` Mainframe: Monitoring status fields specific to Mainframe Replication projects - `pipelines` MonitoringMainframePipelineMonitoringStatus[]: Pipeline-level monitoring statuses - `agents` MonitoringMonitoringMainframeAgents[] - `allocated` integer - `cdctype` string - `flavor` integer - `git` string - `header` MonitoringAgentHeader - … - `id` string - `internalName` string - `latency` MonitoringLatency - … - `message` string - `messageDetails` string[] - `name` string - `pipelineId` string - `pipelineStarted` string - `reportedAt` string - `runtimeServerName` string - `sources` MonitoringSourceInfo[] - … - `status` string - `store` MonitoringStoreInfo - … - `summary` MonitoringSummary - … - `targets` MonitoringTargetInfo[] - … - `used` integer - `version` string - `id` string - `internalName` string - `latencyDetails` MonitoringLatencyDetails - `averageLatency` MonitoringAverageLatency - … - `cumulativeLatency` MonitoringCumulativeLatency - … - `currentLatency` MonitoringCurrentLatency - … - `mailSender` MonitoringMailSender - `mailSent` boolean - `timerStartedAt` string - `name` string - `pipelineId` string - `projectId` string - `reportedAt` string - `tenantId` string - `createdAt` string: Timestamp when the mainframe project status was created - `agents` MonitoringMonitoringMainframeAgents[]: Runtime agent statuses - `allocated` integer - `cdctype` string - `flavor` integer - `git` string - `header` MonitoringAgentHeader - `active` MonitoringAgentState - … - `allocated` integer - `id` string - `lastCommitStck` string - `lastCommitTimestamp` string - `lastLogLsn` string - `pending` MonitoringAgentState - … - `status` string - `used` integer - `id` string - `internalName` string - `latency` MonitoringLatency - `avgTransactionLatency` integer - `totalBacklogLatency` integer - `totalCaptureLatency` integer - `totalReplicationLatency` integer - `transactionBacklogLatency` integer - `transactionCaptureLatency` integer - `transactionReplicationLatency` integer - `transactionsAcknowledged` integer - `message` string - `messageDetails` string[] - `name` string - `pipelineId` string - `pipelineStarted` string - `reportedAt` string - `runtimeServerName` string - `sources` MonitoringSourceInfo[] - `active` MonitoringSourceState - … - `alias` string - `bytesCaptured` integer - `datastore` string - `details` MonitoringDetails[] - … - `index` integer - `key` string - `rowsCaptured` integer - `statsLife` MonitoringSourceStat - … - `statsSession` MonitoringSourceStat - … - `status` string - `store` MonitoringStoreInfo - `cabId` string - `cabName` string - `summary` MonitoringSummary - `bytesApplied` integer - `bytesCaptured` integer - `cummulativeBytesCaptured` integer - `cummulativeRowsCaptured` integer - `rowsApplied` integer - `rowsCaptured` integer - `transactionsCaptured` integer - `targets` MonitoringTargetInfo[] - `alias` string - `bytesApplied` integer - `connected` string - `datastore` string - `details` MonitoringDetails[] - … - `index` integer - `key` string - `lastAckLsn` string - `lastConnection` string - `lastDisconnection` string - `name` string - `recordsDeleted` integer - `recordsInserted` integer - `recordsUpdated` integer - `rowsApplied` integer - `statsLife` MonitoringTargetStat - … - `statsSession` MonitoringTargetStat - … - `used` integer - `version` string - `summary` MonitoringMainframeProjectSummary - `health` string - `lastUpdated` string - `longestCurrentLatencyMs` integer - `totalRowsApplied` integer - `totalRowsCaptured` integer ## Other responses - `400`: Bad request (empty list, more than 50 projects, duplicate projectId, or invalid projectType; DI-ADAPTER-STA-0009) - `401`: Unauthorized - `403`: Forbidden - `500`: Project monitoring statuses retrieval failed (DI-ADAPTER-STA-0001) --- [API](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service.md) · [All operations](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/precisely-integration-adapter-service/revisions/2d2629f4987d?raw)