---
title: "Read an Integration"
method: GET
path: "/pim/v2/integrations/{id}"
tags: ["Integrations (pim/v2)"]
---

# Read an Integration

`GET /pim/v2/integrations/{id}`

[![Early Access](https://img.shields.io/badge/Lifecycle%20Stage-Early%20Access-%2345c6e8)](#section/Versioning/API-Lifecycle-Policy) [![Request Access To Provider Integration](https://img.shields.io/badge/-Request%20Access%20To%20Provider%20Integration-%23bc8540)](mailto:ccloud-api-access+pim-v2-early-access@confluent.io?subject=Request%20to%20join%20pim/v2%20API%20Early%20Access&body=I%E2%80%99d%20like%20to%20join%20the%20Confluent%20Cloud%20API%20Early%20Access%20for%20pim/v2%20to%20provide%20early%20feedback%21%20My%20Cloud%20Organization%20ID%20is%20%3Cretrieve%20from%20https%3A//confluent.cloud/settings/billing/payment%3E.)

Make a request to read an integration.

## Path parameters

- `id` string, required

## Query parameters

- `environment` string, required — Filter a collection by a string search

## Response `200`

Integration.

- object — `Provider Integration` objects represent access to public cloud service provider (CSP) resources that may be accessed by Confluent resources (for example, connectors). The API allows you to create, retrieve, update, delete, and validate individual integrations, and also obtain a list of all your provider integrations. Note: The pim/v2 API currently supports only Azure and GCP provider integrations. Related guide: [Provider Integration in Confluent Cloud](https://docs.confluent.io/home/overview.html). ## The Integrations Model <SchemaDefinition schemaRef="#/components/schemas/pim.v2.Integration" />
  - `api_version` 'pim/v2', required — APIVersion defines the schema version of this representation of a resource.
  - `kind` 'Integration', required — Kind defines the object this REST resource represents.
  - `id` string, required — ID is the "natural identifier" for an object within its scope/namespace; it is normally unique across time but not space. That is, you can assume that the ID will not be reclaimed and reused after an object is deleted ("time"); however, it may collide with IDs for other object `kinds` or objects of the same `kind` within a different scope/namespace ("space").
  - `display_name` string — Display name of Provider Integration.
  - `provider` string — Cloud provider to which access is provided through provider integration.
  - `config` union — Cloud provider specific configuration for the provider integration. Required only when updating integrations with `DRAFT` status. Not required during creation.
    - object — config schema for GCP cloud service provider.
      - `google_service_account` string — The ID of the Google Service Account that Confluent Cloud uses to impersonate customer Google Service Account when it accesses resources in your GCP project.
      - `customer_google_service_account` string — The ID of the Google Service Account that Confluent Cloud impersonates to access resources in your GCP Project.
      - `kind` string, required — Cloud provider specific config to which access is provided through provider integration.
    - object — config schema for Azure cloud service provider.
      - `confluent_multi_tenant_app_id` string — The ID of the Confluent Multi-Tenant App that Confluent Cloud uses to impersonate customer Azure App when it accesses resources in your Azure subscription.
      - `customer_azure_tenant_id` string — The ID of the customer's Azure Active Directory (Azure AD) tenant
      - `kind` string, required — Cloud provider specific config to which access is provided through provider integration.
    - object — config schema for AWS cloud service provider.
      - `iam_role_arn` string — Amazon Resource Name (ARN) that identifies the Amazon Web Services (AWS) Identity and Access Management (IAM) role that Confluent Cloud uses to assume customer IAM role when it accesses resources in your AWS account.
      - `external_id` string, uuid — Unique external ID that Confluent Cloud uses when it assumes the IAM role in your Amazon Web Services (AWS) account.
      - `customer_iam_role_arn` string — Amazon Resource Name (ARN) that identifies the Amazon Web Services (AWS) Identity and Access Management (IAM) role that Confluent Cloud assumes when it accesses resources in your AWS account.
      - `kind` string, required — Cloud provider specific config to which access is provided through provider integration.
  - `usages` string[] — List of resource crns where this integration is being used.
  - `status` string, required — Status of the provider integration. - `DRAFT`: Integration exists but is not associated with customer configuration - `CREATED`: Integration has been associated with customer configuration - `ACTIVE`: Integration is in use by Confluent resources
  - `environment` object, required — The environment to which this belongs.
    - `id` string, required — ID of the referred resource
    - `environment` string — Environment of the referred resource, if env-scoped
    - `related` string, uri, required — API URL for accessing or modifying the referred object
    - `resource_name` string, uri, required — CRN reference to the referred resource
    - `api_version` string — API group and version of the referred resource
    - `kind` string — Kind of the referred resource

## Other responses

- `400` — Bad Request
- `401` — The request lacks valid authentication credentials for this resource.
- `403` — The access credentials were considered insufficient to grant access
- `404` — Not Found
- `429` — Rate Limit Exceeded
- `500` — Oops, something went wrong!

---

[API](https://skmtc.dev/confluent/apis/confluent-cloud-apis.md) · [All operations](https://skmtc.dev/confluent/apis/confluent-cloud-apis/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/confluent/confluent-cloud-apis/revisions/a6a73f98a698/schema)