---
title: "Get diagnostic bundle statuses"
method: GET
path: "/v1/integration/continuous/monitoring/projects/{projectId}/diagnostic-bundles/status"
tags: ["Monitor and Trigger Continuous Integration Projects"]
---

# Get diagnostic bundle statuses

`GET /v1/integration/continuous/monitoring/projects/{projectId}/diagnostic-bundles/status`

## Request

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

Retrieves the statuses of diagnostic bundles for the specified project.
Optionally filter by a specific bundle ID or bundle name using the query parameters. Only one filter can be specified at a time.

Process Overview:
- Validate caller has `replication-pipeline::view` permission.
- If no filters are provided, return statuses for all bundles in the project.
- Provide comprehensive response with bundle details by categories (e.g., agent logs, runtime engine logs).

Key Features:
- Provides comprehensive bundle information with sizes in MB.
- Supports monitoring of ongoing or completed diagnostic processes.
- Optional filtering by bundle ID or bundle name for targeted queries.

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

## Path parameters

- `projectId` string, required

## Query parameters

- `bundleId` string
- `bundleName` string

## Response `200`

Successfully retrieved diagnostic bundle statuses

- DiagnosticBundleStatusResponse: Response containing diagnostic bundle status and log files metadata
  - `id` string: Unique identifier of the diagnostic bundle
  - `bundleName` string: Name of the diagnostic bundle
  - `status` 'UNKNOWN' | 'COMPLETED' | 'IN_PROGRESS' | 'QUEUED' | 'STOPPED' | 'ERROR': Current processing status of the diagnostic bundle
  - `createdAt` string, date-time: Timestamp when the bundle was created in ISO format
  - `sizeInMB` number, double: Total size of the bundle in megabytes
  - `projectId` string: Unique identifier of the associated project
  - `projectName` string: Name of the project
  - `agentId` string: Unique identifier of the agent that generated the bundle
  - `agentName` string: Name of the agent
  - `description` string: Description of the bundle's purpose and contents
  - `createdBy` string: Email of the bundle creator
  - `tenantId` string: Unique identifier of the tenant/organization
  - `location` string: File system path or storage location of the bundle
  - `processName` string: Name of the associated process or pipeline
  - `logMetadata` DiagnosticLogMetadata: Container for organized log files categories
    - `categories` DiagnosticLogCategory[]: Collection of log files categories by source type
      - `name` string: Name of the log files category (e.g., 'Agent logs', 'Runtime engine Server-1')
      - `sizeInMB` number, double: Total size of all log files in this category in MB
      - `status` 'UNKNOWN' | 'COMPLETED' | 'IN_PROGRESS' | 'QUEUED' | 'STOPPED' | 'ERROR': Overall processing status of the category
      - `server` DiagnosticRuntimeServer: Connection details for a runtime engine server
        - `name` string: Name of the server
        - `host` string: Hostname or IP address
        - `port` integer: Port number
        - `type` string: Server type
        - `altIP` string: Alternative IP address
        - `useSSLA` boolean: Whether to use SSL for agent connections
        - `useSSLE` boolean: Whether to use SSL for engine connections
      - `items` DiagnosticLogItem[]: List of individual log files in this category
        - `label` string: Label for the log file type
        - `sizeInMB` number, double: Size of the log file in MB
        - `status` 'UNKNOWN' | 'COMPLETED' | 'IN_PROGRESS' | 'QUEUED' | 'STOPPED' | 'ERROR': Processing status of the log file

## Other responses

- `400`: Bad Request - Validation failed
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

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