---
title: "List Connections"
method: GET
path: "/poweredby/connection/list"
tags: ["Connection"]
---

# List Connections

`GET /poweredby/connection/list`

List Connections returns a list of connections for the sub-account. Use this endpoint for sub-account discovery scenarios. For example, you can reconcile connection mappings after a redirect failure, or look up the per-connection MCP URL for a known external identifier.

## Query parameters

- `driver` string
- `externalId` string

## Response `200`

OK

- ConnectionListResult
  - `connections` ConnectionListItem[] — A list of connections for the account.
    - `id` string, uuid, required — The connection Id.
    - `name` string, required — The connection name.
    - `dataSource` string, required — The data source type (for example, ExcelOnline, MailChimp).
    - `lastModified` string, date-time, required — The date and time the connection was last modified.
    - `externalId` string, nullable — Optional externalId set when the connection was created via redirect. Your identifier for this connection in your own system. Unique within a sub-account (null values are excluded from the uniqueness constraint). Use this field to correlate Connect AI connections with records in your own database. Distinct from the `external_identity` JWT claim, which is a per-request user-level audit identifier.
    - `mcpUrl` string, required — The per-connection MCP endpoint URL, for example, /mcp/connections/{id}.
    - `status` string, required — Connection status. Possible values include Authenticated, NotAuthenticated, and Conditional.

---

[API](https://skmtc.net/cdata/apis/cdata-connect-ai-rest-api-embedded.md) · [All operations](https://skmtc.net/cdata/apis/cdata-connect-ai-rest-api-embedded/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cdata/cdata-connect-ai-rest-api-embedded/versions/c13133ad66c0/schema)