---
title: "GET /environments/{environmentID}/connectorInstances"
method: GET
path: "/environments/{environmentID}/connectorInstances"
tags: ["DaVinci Admin Connector Instances", "DaVinci Admin APIs", "PingOne DaVinci"]
---

# GET /environments/{environmentID}/connectorInstances

`GET /environments/{environmentID}/connectorInstances`

## Request

- Base URL: `https://api.pingone.com/v1`
- URL: `https://api.pingone.com/v1/environments/{environmentID}/connectorInstances`
- Auth: none declared
- TypeScript: <https://skmtc.dev/pingidentity/apis/pingone-platform-api-2/docs/environments/:environmentID/connectorInstances/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `environmentID` string, uuid, required

## Headers

- `X-Ping-External-Session-ID` string
- `X-Ping-External-Transaction-ID` string

## Response `200`

Successful Operation.

- ComPingidentityPingoneDavinciConnectorinstancesResponseConnectorInstancesResponse
  - `_embedded` object, required
    - `connectorInstances` ComPingidentityPingoneDavinciConnectorinstancesResponseConnectorInstanceResponse[], required
      - `_links` object, required
        - `environment` ComPingidentityApiResponseLink, required
          - `href` string, uri, required
          - `name` string
          - `profile` string, uri
          - `title` string, uri
          - `type` string
        - `self` ComPingidentityApiResponseLink, required
          - `href` string, uri, required
          - `name` string
          - `profile` string, uri
          - `title` string, uri
          - `type` string
        - `connectorInstance.clone` ComPingidentityApiResponseLink, required
          - `href` string, uri, required
          - `name` string
          - `profile` string, uri
          - `title` string, uri
          - `type` string
        - `applications` ComPingidentityApiResponseLink
          - `href` string, uri, required
          - `name` string
          - `profile` string, uri
          - `title` string, uri
          - `type` string
        - `deviceAuthenticationPolicies` ComPingidentityApiResponseLink
          - `href` string, uri, required
          - `name` string
          - `profile` string, uri
          - `title` string, uri
          - `type` string
        - `gateways` ComPingidentityApiResponseLink
          - `href` string, uri, required
          - `name` string
          - `profile` string, uri
          - `title` string, uri
          - `type` string
        - `notificationsPolicies` ComPingidentityApiResponseLink
          - `href` string, uri, required
          - `name` string
          - `profile` string, uri
          - `title` string, uri
          - `type` string
      - `connector` ComPingidentityApiRelationshipDaVinciRO, required
        - `id` string, required
      - `environment` ComPingidentityApiRelationshipPingOneRO, required
        - `id` string, uuid, required
      - `id` string, required
      - `name` string, required
      - `createdAt` string, date-time
      - `properties` object
      - `updatedAt` string, date-time
  - `_links` object, required
    - `environment` ComPingidentityApiResponseLink, required
      - `href` string, uri, required
      - `name` string
      - `profile` string, uri
      - `title` string, uri
      - `type` string
    - `self` ComPingidentityApiResponseLink, required
      - `href` string, uri, required
      - `name` string
      - `profile` string, uri
      - `title` string, uri
      - `type` string

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden - Note: This may occur if the environment doesn't exist. Check for environment existence with GET /environments/{environmentID} first. - Note: This may be due to eventual consistency if the environment was recently created. Try again after a short delay.
- `404`: Not Found - Note: This may be due to eventual consistency if the environment was recently created. Try again after a short delay.
- `415`: Unsupported Media Type
- `429`: Too Many Requests
- `500`: Internal Server Error
- `502`: Bad Gateway
- `503`: Service Unavailable

## Changes

- **2025-12-01** (3.1) `6581e0a8e178`: 2 info
  - added the optional property `details/items/innerError/supportedAttributes` to the response with the `400` status
  - added the optional property `details/items/innerError/supportedOperators` to the response with the `400` status
- **2025-11-18** (3.1) `386d2d092d61`: 2 breaking
  - the response property `id` became optional for the status `429`
  - the `id` response property's minLength was decreased from `1` to `0` for the response status `429`
- **2025-08-18** (3.1) `16b3c51ddcde`: 2 breaking
  - the response property `id` became optional for the status `403`
  - the `id` response property's minLength was decreased from `1` to `0` for the response status `403`

[Operation history](https://skmtc.dev/pingidentity/apis/pingone-platform-api-2/changes/environments/:environmentID/connectorInstances/get.md)

---

[API](https://skmtc.dev/pingidentity/apis/pingone-platform-api-2.md) - [All operations](https://skmtc.dev/pingidentity/apis/pingone-platform-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/pingidentity/apis/pingone-platform-api-2/revisions/6ad8bc078fb8?raw)