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

# GET /environments/{environmentID}/connectors

`GET /environments/{environmentID}/connectors`

## Request

- Base URL: `https://api.pingone.com/v1`
- URL: `https://api.pingone.com/v1/environments/{environmentID}/connectors`
- Auth: none declared
- TypeScript: <https://skmtc.dev/pingidentity/apis/pingone-platform-api-2/docs/environments/:environmentID/connectors/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.

- ComPingidentityPingoneDavinciConnectorsResponseConnectorsMinimalResponse
  - `_embedded` object, required
    - `connectors` ComPingidentityPingoneDavinciConnectorsResponseConnectorMinimalResponse[], 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
      - `createdAt` string, date-time, required
      - `environment` ComPingidentityApiRelationshipPingOneRO, required
        - `id` string, uuid, required
      - `id` string, required
      - `metadata` object, required
        - `colors` object
          - `canvas` string
          - `canvasText` string
          - `dark` string
        - `logos` object
          - `canvas` object
            - `imageFileName` string
        - `type` 'core' | 'ping' | 'service'
        - `vendor` string
      - `name` string, required
      - `version` string, required
      - `description` string
      - `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-11-06** (3.1) `a03eedb1a80f`: 4 breaking
  - the response property `_embedded/connectors/items/description` became optional for the status `200`
  - the response property `_embedded/connectors/items/updatedAt` became optional for the status `200`
  - the `_embedded/connectors/items/description` response property's minLength was decreased from `1` to `0` for the response status `200`
  - the `_embedded/connectors/items/updatedAt` response property's minLength was decreased from `1` to `0` for the response status `200`
- **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/connectors/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)