---
title: "Get mainframe project status"
method: GET
path: "/v1/integration/mainframe/monitoring/projects/{projectId}/status"
tags: ["Monitor and Trigger Mainframe Integration Projects"]
---

# Get mainframe project status

`GET /v1/integration/mainframe/monitoring/projects/{projectId}/status`

## Request

- Base URL: `https://integration-adapter.connect.cloud.precisely.com`
- URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/mainframe/monitoring/projects/{projectId}/status`
- Auth: HTTP bearer

Retrieves the status of mainframe pipelines within a specified project.
If a pipelineId is supplied the scope is narrowed to that pipeline. Optionally include latency details.

Process Overview:
- Fetch project and associated pipelines status.
- Filter by pipelineId if provided.
- Optionally enrich with latency detail if requested.

Key Features:
- Lightweight by default (latency details off).
- Supports targeted lookup via pipelineId.

**Required Permissions:** `replication-pipeline::view`

## Path parameters

- `projectId` string, required

## Query parameters

- `pipelineId` string
- `includeLatency` boolean

## Response `200`

Successfully retrieved mainframe project status

- MainframeProjectStatusResponse: Mainframe project status response containing project and pipelines details
  - `tenantId` string: Unique identifier of the workspace/tenant
  - `projectId` string: Unique identifier of the project
  - `reportedAt` string, date-time: Time when the status was reported
  - `pipelines` MainframePipelineStatus[]: List of pipelines with status information
    - `pipelineId` string: Unique pipeline identifier
    - `name` string: Name of the pipeline
    - `runtimeServers` string[]: Runtime servers for the pipeline
    - `status` 'NOT_MOUNTED' | 'MOUNTED' | 'STARTED' | 'RUNNING' | 'STOPPED' | 'PAUSED' | 'OUT_OF_SPACE' | 'STALLED' | 'DEADLOCKED' | 'STOPPING' | 'STARTING' | 'STOPPED_OK' | 'STOPPED_ABEND' | 'STOPPED_ERROR' | 'UNKNOWN': Current status of the pipeline
    - `startedAt` string, date-time: Time when the pipeline started
    - `stats` Stats: Statistics for mainframe pipelines
      - `captured` StatsDetails: Statistics details
        - `rows` integer: Rows count
        - `bytes` integer: Bytes count
        - `transactions` integer: Transactions count
        - `reportedAt` string, date-time: Reported at time
      - `applied` StatsDetails: Statistics details
        - `rows` integer: Rows count
        - `bytes` integer: Bytes count
        - `transactions` integer: Transactions count
        - `reportedAt` string, date-time: Reported at time
    - `latency` Latency: Latency metrics for mainframe pipelines
      - `current` LatencyDetails: Latency details
        - `capture` integer: Capture latency in milliseconds
        - `backlog` integer: Backlog latency in milliseconds
        - `apply` integer: Apply latency in milliseconds
        - `total` integer: Total latency in milliseconds
        - `estimationWindow` integer: Estimation window in hours
        - `reportedAt` string, date-time: Reported at time
      - `average` LatencyDetails: Latency details
        - `capture` integer: Capture latency in milliseconds
        - `backlog` integer: Backlog latency in milliseconds
        - `apply` integer: Apply latency in milliseconds
        - `total` integer: Total latency in milliseconds
        - `estimationWindow` integer: Estimation window in hours
        - `reportedAt` string, date-time: Reported at time

## Other responses

- `400`: Bad Request - Validation failed due to one of the following reasons: - Invalid query parameters
- `401`: Unauthorized - Authentication required, valid credentials not provided
- `403`: Forbidden - User lacks 'replication-pipeline::view' permission
- `404`: Not Found - No status found for the given project or pipeline
- `500`: Internal Server Error - Failed to retrieve mainframe project status.

---

[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)