---
title: "Get connection compatibility matrix for mainframe replication"
method: GET
path: "/v1/integration/mainframe/connection-compatibility"
tags: ["Build and Configure Mainframe Integration Projects"]
---

# Get connection compatibility matrix for mainframe replication

`GET /v1/integration/mainframe/connection-compatibility`

## Request

- Base URL: `https://integration-adapter.connect.cloud.precisely.com`
- URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/mainframe/connection-compatibility`
- Auth: HTTP bearer

Retrieves the connection compatibility matrix for mainframe replication, showing which source
connection types can replicate to which target connection types in mainframe scenarios.

**Process Overview:**
- Returns a list of source connection types with their compatible target types for mainframe replication
- Optionally filter by specific source connection type
- Results are filtered based on feature flags enabled for the current workspace
- Supports sync and reverse sync (distributed to mainframe) scenarios

**Key Features:**
- Provides complete compatibility matrix for mainframe replication scenarios
- Helps in planning mainframe data integration pipelines
- Supports optional filtering by source connection type
- Real-time compatibility based on workspace configuration and feature flags

**Use Cases:**
1. **Pipeline Planning:** Determine valid target connections for mainframe sources before creating pipeline
2. **UI Dropdowns:** Populate target connection dropdowns based on selected mainframe source
3. **Validation:** Verify if a proposed mainframe source-target combination is supported
4. **Reverse Sync Planning:** Identify valid sources for replicating back to mainframe systems

**Supported Connection Types:**
- Mainframe Sources (Sync): VSAM, IMS, DB2ZOS
- Mainframe Targets: ConnectKafka
- Distributed Mainframe Sources (Reverse Sync): ConnectKafka
- Distributed Mainframe Targets (Reverse Sync): DB2ZOS, DB2I
- Local Content-Only Mode: NONE -> NONE

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

## Query parameters

- `connectionType` 'VSAM' | 'IMS' | 'ConnectKafka' | 'DB2ZOS' | 'DB2I' | 'NONE'

## Response `200`

Successfully retrieved connection compatibility matrix

- ConnectionCompatibilityMatrixResponse: Connection compatibility matrix response containing source-target compatibility mappings
  - `compatibilityMatrix` SourceCompatibility[]: List of source connection types with their compatible target connection types
    - `source` 'DB2' | 'DB2I' | 'DB2ZOS' | 'VSAM' | 'IMS' | 'Oracle' | 'Mssql' | 'Kafka' | 'Snowflake' | 'Bigquery' | 'SAPODP' | 'Postgres' | 'SchemaRegistry' | 'NONE': Source connection type
    - `supportedTargets` string[]: List of target connection types compatible with this source

## Other responses

- `400`: Bad Request - Invalid connection type parameter
- `401`: Unauthorized - Authentication required
- `403`: Forbidden - Source connection type not supported or user lacks permission
- `404`: Not Found - No compatible targets available for the specified source
- `500`: Internal Server Error - Failed to retrieve compatibility matrix

---

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