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

# GET /environments/{environmentID}/connectors/{connectorID}

`GET /environments/{environmentID}/connectors/{connectorID}`

## Request

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

## Path parameters

- `environmentID` string, uuid, required
- `connectorID` string, required

## Headers

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

## Response `200`

Successful Operation.

- ComPingidentityPingoneDavinciConnectorsResponseConnectorMinimalResponse
  - `_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

## 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`: 5 breaking, 1 info
  - added the pattern `^(?=\S)[\p{L}\p{M}\p{N}\p{So}/.'_ -]*(?!.*((<)|(\$\{)))` to the `path` request parameter `connectorID`
  - the response property `description` became optional for the status `200`
  - the response property `updatedAt` became optional for the status `200`
  - the `description` response property's minLength was decreased from `1` to `0` for the response status `200`
  - …2 more
- **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/:connectorID/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)