---
title: "GET /connections"
method: GET
path: "/connections"
tags: ["Control plane"]
---

# GET /connections

`GET /connections`

## Request

- Base URL: `https://api.team0.ai/v1`
- URL: `https://api.team0.ai/v1/connections`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://clerk.team0.ai/oauth/authorize`, token URL `https://clerk.team0.ai/oauth/token`)
  - HTTP bearer

## Query parameters

- `cursor` string

## Response `200`

Authorized connection status and capability metadata; never credentials.

- ConnectionList
  - `data` Connection[], required
    - `id` string, required
    - `object` 'connection', required
    - `provider` string, required
    - `status` 'connected' | 'attention_required' | 'disconnected', required
    - `capabilities` string[], required
    - `last_success_at` string, date-time
  - `next_cursor` string, nullable
  - `has_more` boolean, required

## Other responses

- `304`: The authorized connection projection has not changed.
- `default`: RFC 9457 problem response. Cross-tenant identity is non-enumerating.

---

[API](https://skmtc.dev/team0/apis/team0-external-api.md) · [All operations](https://skmtc.dev/team0/apis/team0-external-api/llms.txt) · [OpenAPI document](https://skmtc.dev/team0/apis/team0-external-api/revisions/9b838d20a98f?raw)