---
title: "List integration instances by type"
method: GET
path: "/v1/integrations/{type}"
tags: ["integrations"]
---

# List integration instances by type

`GET /v1/integrations/{type}`

## Path parameters

- `type` string, required

## Query parameters

- `pageSize` integer
- `skipToken` string

## Response `200`

The request has succeeded.

- object
  - `items` IntegrationsIntegration[], required — Integration instances of the requested type.
    - `id` string, required — Stable public integration identifier sourced from the relevant pluginInstanceId. Read from GET responses and passed back on PATCH/DELETE.
    - `type` string, required — Integration type, e.g. nginx or mysql.
    - `displayName` string — User-visible display name.
    - `clientId` string, required — SWO Agent client ID.
    - `parameters` CommonKeyValuePair[], required — Configuration parameters.
      - `key` string, required — Key.
      - `value` string, required — Value.
    - `arrayParameters` IntegrationsArrayParameter[], required — Array-valued configuration parameters.
      - `key` string, required — Parameter name.
      - `values` string[], required — Ordered list of string values.
    - `attributes` CommonKeyValuePair[], required — Custom key-value attributes attached to integration metrics.
      - `key` string, required — Key.
      - `value` string, required — Value.
    - `credentialsRefs` CommonKeyValuePair[], required — Credential references used for integration monitoring.
      - `key` string, required — Key.
      - `value` string, required — Value.
    - `entityIds` string[] — IDs of SWO entities matched for this integration instance. May contain multiple entries; empty when no entity exists.
  - `pageInfo` CommonPageInfo, required
    - `prevPage` string, required — Token for the previous page, or empty string if on the first page.
    - `nextPage` string, required — Token for the next page, or empty string if on the last page.

## Other responses

- `400` — The server could not understand the request due to invalid syntax.
- `401` — Access is unauthorized.
- `500` — Server error

---

[API](https://skmtc.net/solarwinds/apis/solarwinds-observability.md) · [All operations](https://skmtc.net/solarwinds/apis/solarwinds-observability/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/solarwinds/solarwinds-observability/versions/994e5ca64961/schema)