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

# List connections

`GET /api/connections`

## Request

- The document declares no server URL.
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Sourcebot-Api-Key`
  - none

Returns unique code host connections associated with at least one repository visible to the caller. Connection configuration and credentials are never included.

## Response `200`

Connections associated with visible repositories.

- object[]
  - `id` integer, required
  - `name` string, required
  - `connectionType` 'github' | 'gitlab' | 'gitea' | 'gerrit' | 'bitbucket' | 'azuredevops' | 'git', required

## Other responses

- `401`: Authentication is required.
- `500`: Unexpected connection listing failure.

## Changes

- **2026-11-03** `cd10497219e1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sourcebot/apis/sourcebot-public-api/changes/api/connections/get.md)

---

[API](https://skmtc.dev/sourcebot/apis/sourcebot-public-api.md) - [All operations](https://skmtc.dev/sourcebot/apis/sourcebot-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sourcebot/apis/sourcebot-public-api/revisions/cd10497219e1?raw)