---
title: "List connections"
method: GET
path: "/api/v1/connections"
tags: ["Connections"]
---

# List connections

`GET /api/v1/connections`

Retrieves a list of connections in the environment

## Query parameters

- `organization_id` string
- `domain` string
- `include` string

## Response `200`

Successfully retrieved connections

- ConnectionsListConnectionsResponse
  - `connections` ConnectionsListConnection[] — List of connections matching the request criteria
    - `domains` string[] — List of domains configured with this connection
    - `enabled` boolean — Whether the connection is currently active for organization users
    - `id` string — Unique identifier of the connection
    - `key_id` string — Alternative identifier for this connection, typically used in frontend applications or URLs
    - `mcp_server_url` string — MCP virtual server URL for this connection. Agents can point directly at this URL to access only the tools for this connection, without needing to call list_connections or execute_tool with a connection_name. Empty when the MCP virtual servers feature is not enabled for this environment.
    - `organization_id` string — Unique identifier of the organization that owns this connection
    - `organization_name` string — Name of the organization of the connection
    - `provider` 'OKTA' | 'GOOGLE' | 'MICROSOFT_AD' | 'AUTH0' | 'ONELOGIN' | 'PING_IDENTITY' | 'JUMPCLOUD' | 'CUSTOM' | 'GITHUB' | 'GITLAB' | 'LINKEDIN' | 'SALESFORCE' | 'MICROSOFT' | 'IDP_SIMULATOR' | 'SCALEKIT' | 'ADFS'
    - `provider_key` string — Key ID of the identity provider service that handles authentication
    - `status` 'DRAFT' | 'IN_PROGRESS' | 'COMPLETED'
    - `type` 'OIDC' | 'SAML' | 'PASSWORD' | 'OAUTH' | 'PASSWORDLESS' | 'BASIC' | 'BEARER' | 'API_KEY' | 'WEBAUTHN' | 'OAUTH_M2M' | 'TRELLO_OAUTH1' | 'GOOGLE_DWD' | 'TRUSTED_IDP' | 'SMART_FHIR' | 'NO_AUTH'

---

[API](https://skmtc.net/scalekit/apis/scalekit-api-reference.md) · [All operations](https://skmtc.net/scalekit/apis/scalekit-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scalekit/scalekit-api-reference/versions/a40d5d4650e5/schema)