---
title: "List connections"
method: GET
path: "/connections"
tags: ["dataConnectors"]
---

# List connections

`GET /connections`

This method returns a list of the connections in your account. The platform returns your connections sorted by creation date, with the newest at the top of the list.

## Query parameters

- `page` integer
- `page_limit` integer

## Headers

- `x-api-key` string, required

## Response `200`

The connections have been successfully retrieved.

- DataConnectorsListConnectionsResponse200
  - `data` Connection[] — An array containing the connections.
    - `_id` string — The unique identifier of the connection.
    - `provider` 'google_drive' — The data connector provider.
    - `status` 'active' | 'expired' | 'revoked' — The status of the connection. See [The connection object](/v1.3/api-reference/data-connectors/the-connection-object#connection-statuses) for the possible values.
    - `custom_id` string — The label you supplied when you [authorized the connection](/v1.3/api-reference/data-connectors/authorize-a-connection). The platform does not interpret this value, and it does not need to be unique. Multiple connections can share the same `custom_id` value.
    - `account` ConnectionAccount — Information about the connected provider account.
      - `external_id` string — The identifier of the account at the provider. It does not change.
      - `display_name` string — A human-readable label for the account, such as an email address.
    - `scopes` string[] — The scopes granted to the connection.
    - `connected_at` string, date-time — The date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the connection was established.
    - `last_used_at` string, date-time — The date and time, in the RFC 3339 format ("YYYY-MM-DDTHH:mm:ssZ"), when the connection was last used.
  - `page_info` PageInfo — An object that provides information about pagination.
    - `limit_per_page` integer — The maximum number of items on each page.
    - `page` integer — The page you retrieved.
    - `total_page` integer — The total number of pages.
    - `total_results` integer — The total number of results.

## Other responses

- `400` — The request has failed.

## Changes

> 9 revisions in range; 1 not diffed.

- **2026-07-31** `5dbd6e8473c9` — 1 warning
  - removed the optional property `docs_url` from the response with the `400` status
- **2026-07-26** `c0926990c662` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/changes/connections/get.md)

---

[API](https://skmtc.dev/twelvelabs/apis/twelvelabs-api.md) · [All operations](https://skmtc.dev/twelvelabs/apis/twelvelabs-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twelvelabs/twelvelabs-api/revisions/0d3587e9a7c8/schema)