List managed connections given the provided filters

Find managed connections by provider type and current state

Securitybearer
Request
query Parameters
page
number >= 1
Default: 1

Which page of data are you requesting

limit
number [ 1 .. 50 ]
Default: 20

How many items are you requesting

sort
string

Which type of sort (default: CREATED)

Enum: "CREATED_AT" "CONNECTED_AT" "CONNECTION_PROVIDER_TYPE" "CONNECTION_CLIENT_TYPE" "CONNECTION_STATE"
sortDir
string

Which direction to sort the data (default: ASC)

Enum: "ASC" "DESC"
providerTypes
Array of strings (ProviderTypeEnum)

Connection provider types

Items Enum: "IDENTITY" "INFRASTRUCTURE" "VERSION_CONTROL" "TICKETING" "HRIS" "BACKGROUND_CHECK" "SINGLE_SIGN_ON" "ENTERPRISE_SSO" "MDM" "SECURITY_TRAINING" "OBSERVABILITY" "COMMUNICATION" "DIGITAL_SIGNATURE" "EXTERNAL_POLICY" "VULNERABILITY" "EDR" "USER_ACCESS_REVIEW" "CSPM" "CODEBASE" "CYBER_INSURANCE" "CRM" "CUSTOM"
state
string

Connection current state

Enum: "ACTIVE" "MISCONFIGURED" "CONFIGURED_PENDING_CONFIRMATION" "IN_PROGRESS"
Responses
200
401

Invalid Authorization

402

Response Code 402

You must pay to activate this feature

403

You are not allowed to perform this action

412

Response Code: 412

You must accept the Drata terms and conditions to use the API

500

Internal server error

get/connections
Request samples 
Response samples 
application/json
{
  • "data": [
    • {
      • "id": "1",
      • "clientType": "GOOGLE",
      • "state": "ACTIVE",
      • "connected": false,
      • "connectedAt": "2025-04-17T18:35:53.532Z",
      • "failedAt": "2025-04-17T18:35:53.532Z",
      • "clientId": "abc123",
      • "clientAlias": "My-connection-alias-1",
      • "aliasUpdatedAt": "2025-04-17T18:35:53.532Z",
      • "deletedAt": "2025-04-17T18:35:53.532Z",
      • "providerTypes": [
        • {
          • "value": "MDM",
          • "isEnabled": true
          }
        ],
      • "code": 10010,
      • "groupLabel": "Everyone"
      }
    ],
  • "page": 1,
  • "limit": 10,
  • "total": 100
}