---
title: "Retrieve the Metabase for one pipeline connection"
method: GET
path: "/v1/integration/projects/{projectId}/connections/{connectionId}/metabases"
tags: ["Unified Project Lifecycle APIs"]
---

# Retrieve the Metabase for one pipeline connection

`GET /v1/integration/projects/{projectId}/connections/{connectionId}/metabases`

## Request

- Base URL: `https://integration-adapter.connect.cloud.precisely.com`
- URL: `https://integration-adapter.connect.cloud.precisely.com/v1/integration/projects/{projectId}/connections/{connectionId}/metabases`
- Auth: HTTP bearer

Retrieves the Metabase bound to one project connection.

**Features:**
- Returns Metabase details (name, vault connection, operational parameters).
- Password fields are always masked or omitted.

**Use Cases:**
- Inspect an existing Metabase before configuring a pipeline.
- Verify Metabase state after a composite configuration call.

**Authorization:** Requires `replication-pipeline::view`.

## Path parameters

- `projectId` string, required
- `connectionId` string, required

## Query parameters

- `projectType` 'REPLICATION' | 'MAINFRAME_REPLICATION' | 'ADVANCED_REPLICATION': Supported project types for unified project operations

## Response `200`

Successfully retrieved Metabase

## Other responses

- `400`: Bad request — MAINFRAME_REPLICATION is not supported (DI-ADAPTER-PRJ-0013)
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Metabase not found (DI-ADAPTER-MBS-0004)
- `500`: Internal server error (DI-ADAPTER-MBS-0005)

---

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